Home

VistA Imaging System Background Processor User Manual

1. Imaging Site Parameters Messages Mail Groups Purge BP Servers Queue Manager poke Last Verify BP Server E S 5 gt Purge By Retention Days Retention Dates e Da Full Files 9999 10 21 1983 Date Created Aus m Date Modified BigFiles 9999 10 21 1983 Check TextFiles AbstractFiles 9999 10 21 1983 Photo IDs 99999 5 23 1737 Frequency in days 1 Next Verifier Date 2 7 2011 Auto Purge V Last Purge BP Server Verifier Time 2355 Purge Factor 1 7 Scheduled RAID Group Advance p Express Purge Active v Purge Rate 100000 Last RAID Advance Scheduled Purge Frequency in days Active M Next Advance Date 3 12 2011 Last Purge Date 3 3 2011 Advance Time 2355 Frequency days 7 Next Purge Date 3 11 2011 Purge Time 2355 3v Appl Help 28 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 3 5 1 Purge Settings The Purge process is used to remove image files from the RAID when the free space is low or when older and or not recently viewed image files can be purged to allow room for newly acquired images It is important to note that no file is purged from the RAID shares if it has not been verified and confirmed as saved on the archive storage jukebox The Purge
2. January 2012 Field Description STORAGE TYPE ROUTER HASH SUBDIRECTORY A flat or hierarchal folder structure will be created used default is hashed display only ABSTRACT Abstract files can be copied FULL Full files can be copied BIG BIG files can be copied DICOM DCM files can be copied COMPRESSION Data compression decompression is used on the files being sent to the remote server Either none or JPEG 2000 found on the table not on the properties page can be edited by VA Fileman USERNAME Windows login Username for the remote server where the images will be sent This account must have READ WRITE access to the remote share PASSWORD Windows login Password for the remote server where the images will be sent MAX RETRY ON Number of times that will be attempted to get a CONNECT connection to the remote server using the AutoRouter software before a failure message is generated MAX RETRY ON Number of times that a copy will be attempted to the TRANSMIT remote server using the AutoRouter software before a failure message is generated SYNTAX UNC The connection to the share will be in the format server share_name Found on the table not on the properties page can be edited by VA Fileman SUBDIRECTORY Name of a subdirectory where files are to be stored The value of this field is concatenated to the name of the network location the physical
3. 84 CHAPTERS 86 5 1 Application Description ninnisin eie ROI YR RS ERES A D sU RATS UR 86 23 2 U phe ote 86 Pm 86 5 4 Understanding Processing te o rere ers NU Re Sua 87 5 4 1 Reasons for Running the Verifier 88 January 2012 Background Processor User Manual Rev 10 vii VistA Imaging MAG 3 0 121 5 5 Maintenance Operations 88 SL Integub ad epi 89 Serb File nte SEHE VS tore addita 89 95912 Patient 89 222 TextFile Ite 91 5 6 Stara g R nnine the VerrHet 92 304 ados des sexes 97 Eog EU EE 97 5 71 Log Bile m 98 71222 ANO ATO ve 99 57 e 100 5 7 4 DENError Log Files 102 104 5 7 2 1 Imaging Integrity Chieck messaPe 104 5 7 2 2 Sit Venfication 85 104 5 7 2 3 Verifier Scan Error Log message des estin 105 Chapter 6 oio eco 106 Gil Applica
4. 1 1 2 VistA Imaging and the Background 2 1 3 VistA Imaging Functional PLOW cse ho Don b 3 1 4 Features of the Background Proo6880L e eU Re REPE HERE UR 4 1 5 The Background Processor Usage and Maintenance of RAID 4 155 6 RAID Group Guidelines EE NE DRIN E 5 1 5 2 Additional Maintenance of usd as ore e Uer tu dee 6 Chapter 2 Setting Up Your BP System 4 44 444 4 7 2 1 Software Requirements eerte EN pA UR PARERE decease UE 7 2 2 Hardy are Requitemehlis os eee co eue dass e PR ned 7 2s Requirements TD 8 2 3 1 Windows Security iocos 8 239 VISTA 8 2 9 2 Securty Keys dn VISUX 9 2A nail A i f 9 2 5 Configuring 9 29L Guidelines P 9 2 5 2 Add
5. 92 3 7 3 Editing the Properties of a Network 53 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 3 74 Adding a RAID shea tec 54 37 5 Queue for 2 2 000000000 55 Chapter Queue PrOCGSSOE 57 4 1 Application DES Cri pu Oils 57 4 2 Setup Guidelimes usse e ER US RU IEEE 57 LM WA i tee Tn EDT 58 4A Understanding PROCESSING oet teet ope 63 4 5 Starting Running the Application 64 4 5 1 Starting the Application and Analyzing the 64 ca adt ena dot 66 ASG 68 Lok Log PRU 68 46 11 Back Proc ise Spera e 69 BROBIIORE LOB 70 Oa 70 4021 Hoc Image Site Sage iacent t a 71 4 6 2 2 Application Process Failure 71 4 6 2 3 Auto RAID Purge unii estela estatus 72 42 0 24 72 46 25 Next RAID Group
6. 122 Wb se valiating EVAL QUEUES 122 7 1 2 Reporting Using Mail ees esie veas t eu Pera 122 12 Configuring the BP Server ise e t eger pev tesa pie o de NEUE Nd UE 123 7 3 Scheduling the BP Server Monitor e eterne t nio nocens node Inda rone eaa vo need en 123 Example of Sehedultns uu tes oet oe 123 7 3 22 Tasking BP Server Monitor Menu Options 124 7 3 2 17 cun cae 124 7535225 1 2 fist eu ul pho si dor Ut eu 125 viii Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 74 Monitoring the BP Queue Processor eie eter d epi cet ede e t 125 7 4 1 Precautionary CnudeliDessc 125 T2E2 Daily MONOT Me mte 126 T gt Monitoring the BP Veniet io re RAE 126 4 67 Monitoring tie Pur ge i 127 KOL Precautionary Guidelines dut uad 127 Chapter 8 Troubleshooting 128 8 1 General 128 8 1 Network COnneetlofos oues eroe ger 128 lt coa Aude us 129 5
7. site name IMAGPROVIDERONETWOONEFOUR ONETWOONEFOUR JUL 20 20098122018 has an ABS already 2 37 site name IMAGPROVIDERONETWOONEFOURONETWOONEFOUR 34420 2009812 20 13 has an ABS already Active 0 5 GCC Failed 0 Aclive 3 526CC site name IMAGPROVIDERONETWODONEFDOUR ONETWODNEFOUR JUL 20 20092122018 NOT PROCESSED 9537 538 name IMAGPROVIDERONETWOONEFOUR ONETWOONEFOUR JUL 20 20098122018 NOT PROCESSED 3538 site name IMAGPROVIDERONE TWOONEFOURONETWOONEFOUR JUL 20 20098122018 NOT PROCESSED 3533 f JBTOHD Active 12 38JBTOHD site name IMAGPROVIDERONETWOONEFOUR ONETWOONEFOUR JUL 20 20099122018 NOT PROCESSED 33J8TOHD site name IMAGPROVIDERONETW OONEFOUR ONETWOONEFOUR JUL 20 200961122018 NOT PROCESSED 40JBTOHD site name IMAGPROVIDERONETWOONEFOUR ONETWOONEFOUR JUL 20 202961220218 NOT PROCESSED TJUKEBOX site name IMAGPROVIDERONETWDONEFDUR ONETWODNEFOUR JUL 20 20096122018 NOT PROCESSED 2JUKEBQX site name IMAGPROVIDERONETWOONEFOUR ONETWOONEFOUR JUL 20 20963122018 PROCESSED 3JUKEBOX site name IMAGPROVIDERONETwOONEFOUR ONETwOONEFOUR JUL 20 20099122018 PROCESSED 4 JHTORU site name IMAGPROVIDERONETwDONEFOUR ONETwOONEFOUR JUL 20 200968122018 PROCESSED Failed 0 gt Active 2 SOPREFET site name IMAGPAOVIDERONETWOONEFOUR ONETWOONEFOUR JUL 20 20095122018 NOT PROCESSED 51 site name IMAGPROVIDERONETWOONEFOUR_
8. Operational Status Read Only Hashed Cancel y Apply Help 3 Modify of the enabled settings 4 Click Apply and OK to add the changes to the database and exit or click OK to add the changes and exit 3 7 4 Adding a RAID Group 1 From the Queue Processor menu bar select Edit gt Network Location Manager to open the following window The RAID tab is automatically selected xl RAID JUKEBOX Routers GCC EKG URLs Diagrams E 2E RG ATGT MAG5H MAGBH amp RG ATG2 MAGIH MAG2H amp RG ATG3 MAG H MAG8H 3 MAGSH RG ATG4 32 MAG12H MAG13H 2 2362728 775408 On Line 28 WVHA 2362728 1427210 On Line MAGNETIC MAGNETIC YES List View Style New Add Group Cancel S Apply Help List Report 2 Click the Add Group button at the bottom A new RAID group is added to the tree For this example the name would be RG ATGS 54 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 3 7 5 Queue for PhotoID The GCC has a method for exporting photo IDs to a designated share as a post capture process Its implementation requires an entry in the IMAGE ACTIONS file 2005 86 Its purpose is to export the files to a site specified print server or share either w
9. DATE Oct 27 2009 08 57 21 EST Production Account 0 The Photo ID protocol in the IMAGE ACTION file 2005 86 could not resolve the target export location as currently defined Update the EXPORT LOCATION field for the PHOTO ID COPY entry in IMAGE ACTION file 4 6 2 11 Scheduled Purge Failure This message is sent when the Scheduled Purge does not start at the designated time Example Subj Scheduled Purge failure 31195 10 27 09 12 40 4 lines From VistA Imaging basket Page 1 New SITE IMGxxxxx MED VA GOV DATE Oct 27 2009 12 40 01 EST he SALT LAKE CITY implementation of VistA Imaging has failed to start the sche dule Purge activity The task is currently assigned to BP Server ISW xxxxx LT 4 6 2 12 Scheduled RAID Group Advance Failure This message is sent when the system cannot change to another RAID Group because none of the groups has enough free space Example Subj Scheduled RAID Group Advance failure 31783 04 02 10 03 20 3 lines From VistA Imaging MAGO FS CHNGE basket Page 1 SITE IMGDEMO1 MED VA GOV DATE Apr 02 2010803 20 06 EST The scheduled RAID Group Advance failed January 2012 Background Processor User Manual Rev 10 75 VistA Imaging MAG 3 0 121 4 6 2 13 Scheduled Verifier Failure This message is sent when the Scheduled Verifier does not start at
10. Read Only Hashed X Field Description NETWORK LOCATION Name of a RAID share on the Imaging cluster Note Use MAGnH names for these shares is unique number H indicates the file directory structure is hashed The record number VistA for this Network Location PHYSICAL REFERENCE The UNC Universal Naming Convention containing the server and share name for the RAID storage TOTAL SPACE Storage capacity for the share FREE SPACE Free space remaining on the share OPERATIONAL STATUS Logical state of the share or OFFLINF READ ONLY If set data can be read but not written to this share In addition Purge and Auto Write will not consider this share as a candidate for purge or new image storage STORAGE TYPE MAGNETIC for magnetic media HASH SUBDIRECTORY A hierarchal folder structure will be created used default is hashed display only 44 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 3 7 1 2 Jukebox Tab Most sites have local archive storage jukebox Some sites have a remote archive where multiple sites share the same storage The images that are initially copied to the RAID are copied from the RAID to the archive device The archive devices have one or more shares where the images are copied for long term storage For remote consolidated archive storage each site has its own
11. to create the complete path name RETENTION PERIOD Time in days that image files are kept on the remote server before they are purged LAST PURGE DATE Date time of last purge on the remote server SITE Name of the remote location Note Use a name different from the NETWORK LOCATION name This string is displayed in VistARad in the column TIME OFFLINE Date and time that this server was inaccessible Set by the routing application found on the table not on the properties page Background Processor User Manual Rev 10 47 VistA Imaging MAG 3 0 121 3 7 1 4 Tab Photo ID images etc can be sent to a remote location directly from the Queue Processor software These images are written to a share on the remote server using the Username Password contained in the properties of this storage type To edit the properties of a network location right click the entry and select Properties on the pop up menu Note This popup menu can also be accessed from the keyboard by using Shift F10 lol x Hidden Hidden A Now f X cos Se Propone Field Description NETWORK LOCATION N ame of a share on the server where the Photo ID etc will be sent Note Use names to reflect the type of transfer for these shares IEN The record number in VistA for this Network Location PHYSICAL REFERENCE The UNC Universa
12. Text file Patients ID SSN in the top section DATA1 of the text file does not match DICOM 0010 0020 field in the bottom section DICOM DATA PATIENTS NAME MAGPATIENT 98755 PATIENTS AGE 81 PATIENTS_SEX M IMAGE_DATE 05 1 0 2001 RESCALE_INTERCEPT 0 RESCALE_SLOPE 1 DATA1 BEGIN DICOM DATA 0002 0000 Group Length UL 1 0002 0001 File Meta Informatior Version OB 1 110 0008 221 Anatomic Region Sequance Sal 0010 001jPatients Narne PNI1 1 NAGPATIENTH 2345 0010 0040 Patient s 11M 0010 1010 Patient s Age AS 1 1 053Y 8END DICOM DATA Text file 150 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 151 Glossary Term Definition AA Acronym for Archive Appliance Abstract A thumbnail version of an image which requires less computer processing resources to display than the actual image Abstract images typically have an abs extension One of the queues of the BP queue processor is also called the ABSTRACT queue Aggregate To gather together as into a single referenced location The parent term aggregate function is triggered by any action that causes a portion of an image set to be copied to the current jukebox location The aggregate function ensures that the entire image set is copied to the same location Archiv
13. 72 462 6 Image Cache Critically Low isis 73 4 6 2 7 Image Fie size Var ance SO 73 INSTALLATION a a e 74 4 6 2 9 Monthly Image Site Usage eret tite tenian ie nsa e eate vo Pecan 74 4 6 2 10 Photo A CU OM ee perse deb epu ovy 75 2 65 24 LT Scheduled Purpe Parte 73 4 6 2 12 Scheduled RAID Group Advance Failure sess 75 4 6 2 13 5 76 4 6 2 14 Site_Report_Task_Was_Restarted 000 76 4 6 2 15 76 4 6 2 16 VI Queue Processor Failure 77 4 6 2 17 Rescinded Watermarking Successful 77 4 6 2 18 Rescinded Watermarking Failed 2 78 4 0 3 7Sereen Genetated edu dd ie 78 4 6 5 1 SIZE no see n e 78 46 3 2 JBTOHD 79 4 6 3 3 IMPORT Queue Status Report 80 4 6 3 4 Purge Queue by Type Entries osa eoi 83 4 0225 7308
14. JBTOHD Faled 0 Active 18 5JBTOHD Site BACKGROUNDJUSER 11 2010 055654 NOT PROCESSED 8822 ABSTRACT site BACKGROUND USER 11 20103065554 NOT PROCESSED 8822 FULL 8J8TOHD BACKGROUNDUSER Queue NOT_PROCESSED 8823 ABSTRACT 908040 BACKGROUND USER Burge Queue NOT PROCESSEO 8823 FULL 10087040 BACKGROUND USER __set QueveParttion PROCESSED 8823 BIG 11087040 faite BACKGROUND USER 11 20102055654 NOT PROCESSED 8825 ABSTFACT 2 From the popup menu select Set Queue Partition The entries above the selected one will move to the Failed queue The selected entry will be the top entry in the Active queue and will be the next queue entry processed SJBTOHD BACKGROUND USER 11 21020655554 NOT PROCESSED 8822 ABSTRACT 6J8TOHO faite BACKGROUND USER MAR 11 2102065554 NOT PROCESSED 8822 FUL 7 BTOHD BACKGROUND USER MAR 11 21082065654 NOT PROCESSED 9822 BIG 8J8TOHD BACKGROUND USER 11 20109065564 NOT PROCESSED 8823 ABSTRACT 9J8TOHD BACKGROUND USERI MAR 11 21080656554 NOT PROCESSED 8823 FULL 10J8TOHD 7 BACKGROUND USER 11 20102055654 PROCESSED BIG 11 J8TOHD T BACKGROUND USER 11 20103055654 PROCESSED ABSTFACT 12J8T0HD BACKGROUND USER 11 21020655654 NOT PROCESSED FULL 13J8TOHD i BACKGROUND USER MAR 11 20108065554 NOT PROCESSED BIG 14J8TOHO j BACKGROUND USER 11 22105055554
15. No ABS JB Files No abstract file found on the jukebox Check shares for existence of ABS file If not found restore ABS file from backup tapes No Acquisition Site in Image file The ACQUISITION SITE field 100 in the IMAGE file 2005 is missing This is a required field Contact IRM Update the field with the proper site ID No FULL JB Files FULL file not found on the Check shares for existence of Full jukebox file If not found restore Full file from backup tapes No FULL VC Files FULL file not found on the None Image share No jukebox BIG Files BIG file not found on the Check shares for existence of BIG jukebox file If not found restore BIG file from backup tapes No jukebox FULL Files FULL file not found on the Check shares for existence of Full jukebox file If not found restore Full file from backup tapes No Network References No IMAGE file 2005 record exists for this image Re import image thru the Capture client No Network References Image has been archived resides None Archived Image in the IMAGE AUDIT file 2005 1 No VC BIG Files Could not find the BIG file on None the image share Not Certed Could not find create file type on Check shares for existence of BIG jukebox file If not found restore BIG file from backup tapes Problem rename log file Permission problem with log file Set WRITE permissions set on share folder file for Windows logi
16. choose to establish a pattern to utilize your entire RAID by scheduling a weekly RAID Group advance and coordinating this with a scheduled purge followed by weekly backup of the RAID Group that was most previously active See section 3 5 3 RAID Group Advance Settings for details e An automatic RAID Group Advance occurs as follows o When the used space all the shares in a RAID Group exceeds the high water mark the software will change the current write RAID Group to the next one in sequence and recorded in BackProc log file See section 3 2 2 Storage Functions Settings for more details The picture below is a visual showing the changing of a RAID Group Auto Purge Breached When the Server Reserve within the RAID Group ias Ones C multiplied by the Purge Factor magi Grop f ostia has been breached an Auto Purge is triggered for the next RAID Group Y The Purge Factor is a number that can be adjusted by the site to offset the length of time a purge will take Default 1 Set itto 2 once you populate the next RG Image Group January 2012 Background Processor User Manual Rev 10 5 VistA Imaging MAG 3 0 121 1 5 2 Additional Maintenance of RAID The following utilities support the Background Processor e MagDexter used to create summary and detail platter reports containing platter information such as the name serial number and status of each jukebox platter e MagKat used to backfill specific
17. Windows Session Action Errors ACTION IMPORT ACTION Data ACQD ACTION Data ACQL 69 ACTION Data ACQS 660 ACTION Data GDESC DENTAL IMAGE Result ACTION Data IDFN 714 ACTION Data PXDT 3030123 16381 ACTION Data PXIEN 393 ACTION Data PXPKG 8925 ACTION Data STSCB ISTAT MDAPI ACTION Data TRKID 3 3030123 16381 ACTION Data TRTYPE NEW ACTION Image 1 c program files vista imaging image patient photoid DENTAL IMAGE image 1 out of 1 ERROR New Error ERROR 0 Required parameter is null ERROR Acquisition Device is Required Acquisition Session File tab displayed Import Queue Status x Import Tracking ID Looki Import Queue Looku 3502 Found in Image file 2005 Internal entry 21762 Image file name GOO00000021 762 TIF Windows Session 2006 82 Acquisition Session 82006 041 Import Queue File 2006 034 Acquisition Session IEN QUEUE TRACKING ID ACTIVITY TIME QUEUE STATUS TEST 0927 4 QUEUING APR 22 2010 14 13 49 57 0927 4 QUEUE STATUS 22 2010 14 14 25 IMPORT in progress TEST 08274 QUEUE STATUS 22 2010 14 14 25 Tracking ID TEST IMPORT complete VHAISWIMGVMSIMAGEGOGOTIF January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 81 Description Import Tracking ID Lookup Unique identifi
18. summary sheet is displayed PurgeResults Manual Purge Run Summary Start Date 8 26 2010 Start Time 11 36 19 AM Run Time 0 0 9 JB Queues 0 Purge Site Parameters Site File Prefix DM GO IE Abstract keep days 1800 Full keep days 1800 Big keep days 1800 Photo ID keep days 1800 Purge Criteria DATE MODIFIED ExpressPurge OFF RAID Share Count Total Share Files 21 Total Abstracts 7 Total Full 7 Total Big 0 Total Text 7 Photo ID 0 Foreign 0 Purge File Count Total Share Files Deleted 18 Purged Abstracts 6 Purged Full 6 Purged Big 0 Purged Text 6 Purged Photo ID 0 Purged Foreign 0 Vist amp RAID Shares Purged WHAISWIMGYMS400 IMAGEB Purged Note You can view the results in a log by selecting File gt Open log from the menu bar Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 The purge results are displayed by file type in the lower section of the window along with a purge results summary The resulting data is described in the table that follows Edit Help p Purged Files Date LastAccessed oB588 Abstract Full Image SLC VistA Imaging BP Purge by lalxl Stop Share Processing 5 AVHAISWIMGS1 IMAGE1 DM 00 08 Purged Activities StartDate 8 26 2010 Start Time 11 4114 Run Time Hrs min secs 0 0 5 Total Files 182 Purge Count 0 JB Queues 0
19. June 2005 Patch 13 4 Expanded and updated Verifier content Moved Verifier content from the end of initial manual and created a separate manual June 2005 Patch 20 5 Updated Background Processor content in this manual Extracted the entire Chapter 4 Verifier content and created a new manual which contains the extracted content Dec 2005 Patch 20 6 Updated Background Processor content in this manual Feb 2006 Patch 20 7 Updated sections 5 5 3 thru 5 5 5 1 VistARad 2006 Patch 20 8 Replaced all with VistA Imaging Shares Mar 2011 Patch 39 9 Revamped content added new Patch 39 features merged content from Verifier User Manual Globally replaced term BP Workstation with BP Server 1 2 and 3 WPRs completed Jan 2012 Patch 121 10 Updated sections 4 1 4 3 8 2 2 Added sections 4 6 2 17 and 4 6 2 18 C Gilbert H Suri L Scorza Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 Preface The purpose of this manual is to provide users with instructions on using the VistA Imaging Background Processor BP V 3 0 software and system components It includes explanations of the options and controls available from the VistA Imaging Background Processor Instructions are provided about how to perform various system tasks Note Additional information about the various VistA Imaging components such as servers workstations Remote Procedure Call RP
20. e Application Description e Setting up e Tasking e Understanding Processing Starting Running the application e Reports 6 1 Application Description Image files are part of the patient s record and must be preserved for the required number of years Image files may be kept online indefinitely in long term storage However image files in temporary storage must be purged periodically to provide ongoing free disk space for new images The primary purpose of the Purge is to delete files in temporary storage in order to maintain a percentage of free disk space at all times The Purge can be run manually scheduled or run automatically An express purge is available to dramatically decrease the time it takes to purge a share 6 2 Setting Up The Purge software will need to be installed on a Server class machine The Purge requires a BP Server defined for the server on which it will run Section 3 In addition the Broker port connection needs to be set up Appendix A Check the network connections to the RAID shares and archive device shares to make sure they are online and the Windows account that will be used for logging into the workstation has READ WRITE permission to those shares 6 3 Tasking If the Purge is to be run automatically when a share RAID Group exceeds the Server Reserve threshold the AUTO PURGE task will need to be assigned to the BP Server 6 4 Understanding Processing Guidelines 1 You should first determi
21. 2 DFN MISMATCHES IN AP IMAGE MULT 000000575 154 000000154 3 eo 2 564 PATIENT FIVESE 575 DFN MISMATCHES IN AP IMAGE MULT 000000575 154 000000154 3 eo 2 665 PATIENT FIVESE 575 666 PATIENT NINESE 975 DFN MISMATCHES IN AP IMAGE MULT 000000575 PATIENT ONEFIV 154 000000154 3 eo 2 Contlicting 000000975 PATIENT SIXSEV 678 000000678 ENDO 12 GP 4 amp Image DFNs 567 PATIENT NINESE 975 CONFLICTING 000000975 PATIENT SIXSEV 678 000000678 ENDO 12 eo 2 AP amp IMAGE DFNS 568 PATIENT NINESE 975 CONFLICTING 000000975 PATIENT SIXSEV 678 000000678 ENDO 12 50 2 amp IMAGE DFNS 669 PATIENT SIXSEV 678 DFN Mismatches in AP Image Mult 000000678 PATIENT NINESE 975 000000975 ENDO 42 GP 2 Name Description Image_IEN IMAGE record currently being processed Patient_Name_1 Patient name for current IEN DFN_1 SSN I Patient file IEN for current record Social Security Number for current patient Patient Name 2 Patient name in linked Radiology report TIU Note DEN 2 SSN 2 IMAGE file 2005 in linked report Social Security Number of Patient in linked report Package PROCEDURE field 6 in IMAGE file 2005 Background Processor User Manual Rev 10 VistA Imaging M
22. 43 46 Router in Network Location Manager 43 Routing rules file 43 RPC Broker configuring 141 Scan 91 Scan log file 97 ScanError log file 99 Scheduled Purge Failure message 75 117 Scheduled RAID Group Advance Failure 75 Scheduled Verifier Failure message 76 SCHEDULED VERIFIER task 85 SCHEDULED VERIFY queue 12 Screen generated output 508 Compliance 83 IMPORT Queue Status 79 JBTOHD Report 79 Purge Queue by Type entries 82 Server Size 78 Section 508 83 Security Windows 8 Security keys MAG SYSTEM 8 9 20 MAG WINDOWS 9 Server Size output 78 Setting up your BP system 7 Setup requirements 8 Site code 17 configuring parameters 16 name of remote location 47 Site Report Task Was Restarted message 76 Site usage report 74 Software requirements 7 Status counts active failed 39 Storage Type 65 Study Instance UID 90 T Tape backup 68 Tasks ABSTRACT 60 assigned as queues 12 assigned to BP Servers 57 DELETE 62 EVAL 63 GCC 62 IMPORT 61 JBTOHD 59 JUKEBOX 61 60 Timeout VistARad 19 Timeout Windows Capture 19 Timeout Windows Display 19 Transmission frequency mail messages 23 Troubleshooting broker failure 128 general startup 127 integrity messages on patient data 136 network connection 127 not enough process memory 128 not enough server cache 128 not enough write cache available 128 output H
23. 43 Routers 46 URLs 50 WORM OTG type of storage 65 WORMOTGnH 43 X XTMP global 81 January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 163
24. D The BP Purge should not be run under the following conditions e When the jukebox or VistA Imaging shares access is compromised e When excessive jukebox copies will automatically be queued by the BP Purge because copies cannot be verified on the jukebox e When the BP Purge does not have access to the VistA Imaging shares it is intended to purge e When the VistA hospital system is not available e When the RPC Broker Listener is not active e When the network is down January 2012 Background Processor User Manual Rev 10 127 VistA Imaging MAG 3 0 121 Chapter 8 Troubleshooting e General Startup e Queue Processor e Verifier 8 1 General Startup 8 1 1 Network Connection Check all the online VistA Imaging shares and jukebox shares by one of the following means to determine if the BP has access to the folders files on the shares There are several methods to test the connectivity 1 From the Main BP window select the View gt Server Size option The free space should display for each share i M SALT LAKE CITY BP Queue Processo File Edt view Help Server Size JBTOHD Report Networ Import Queue Purge ReQueue type Using Windows Explorer on the destination device Image cluster or Windows based Jukebox server show the properties of the VistA Imaging shares and jukebox shares The VHAxxxIA account that is used to log into the BP Server should have READ WRITE access to both the shares and
25. QRT istA Imaging BP Purge by 151 File Edit Help pPugedFles Date Last Accessed Stat Share Processing Start Date Start Time Run Time Hrs min secs Total Files Purge Count JB Queues Purge Criteria Count Purge Parameters 1 Original File Counts 3 Select Edit gt Select Shares The Purge Share Select window displays the shares Share Select WHAISWIMGVMS404 IMAGE1 Ze SVHAISWIMGVMS 404NIMAGE 10 WHAISWIMGYMS 404 IMAGE21 4 Ze MAGIH SVHAISWIMGVMS 404 IMAGE1 MAG2 WHAISWIMGVMS404 IMAGE2 MAGSH WHAISWIMGVMS404 IMAGE3 WHAISWIMGVMS404 IMAGE4 MAGSH WHAISWIMGVMS404 IMAGE5 Ze MAGEH WHAISWIMGVMS404 IMAGEBS Ze MAG H WHAISWIMGVMS404 IMAGE 7 Z2 MAGSH WHAISWIMGYMS404 IMAGEB Zw MAGIH WHAISWIMGYMS404 IMAGE S Apply Help 4 Highlight the shares to be purged and click OK 5 Click the Start button 6 Click OK in the message to confirm the shares to be purged 9 Do you wish to purge these RAID shares with these parameters OK 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 112 The window closes and the Purge starts When the Purge is complete
26. When a Scheduled Verifier starts the time is recorded in the VistA database in the field Last Verifier Date The Frequency is added to this date to determine when the Verifier will run again 36 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 3 5 3 RAID Group Advance Settings RAID groups are used to organize RAID shares into logical groups for easy tape backup and restore processing During the install all existing online Imaging shares are placed into the first RAID Group RG GO1 This configuration is the same that has been in existence for past years The auto update functionality is also the same At regular intervals the current write location will change to the share with the most free space The Auto Write function will reset the current write location to provide load balancing within the RAID group When the Server Reserve within the group has been breached the Auto Write will set the next RAID group as the current write group In addition when the used space in that RAID Group has reached the high water mark the next RAID Group that has online shares will become the current RAID Group 3 5 3 1 Configuring the Scheduled RAID Group Advance Settings Scheduled RAID Group Advance a Active Last RAID Advance Frequency in days Next Advance Date Advance Time Field or Checkbox Description Scheduled RAID Group Advance box Active Enable RAI
27. Conditions Allowing Viewing The following integrity issues will not prevent their respective images from being displayed These are informational messages Message Explanation Action No AP Ptr The IMAGE file 2005 record is missing the PARENT DATA FILE 16 for a Clinical Association Report AP This Image does not have the entry in the clinical application AP specified Future utility patch No AP entry Ptr This Image does not have the entry in the clinical application AP specified The IMAGE file 2005 record is missing the PARENT GLOBAL ROOT DO 17 for a Clinical Association Report AP Future utility patch 8 4 Purge Message Explanation Action Broker Reconnection failed Auto login after a Broker disconnect failed Check network Contact IRM Create Process failed ProgramName Windows failed to create a process Reboot the server Express Purge Rate limit CurrentShare reached PurgeRate on share The purge terminated on the given share because Express Purge was active and the Purge process exceeded the user defined purge rate None File Delete failure filename The file listed could not be deleted Check permissions on the share folder file File in use filename File purged filename The Image file 2005 was not updated The log file is in use The file was deleted on the RAID but the pointer in V
28. If you see these ABSTRACT tasks failing the JBTOHD task should be added to server running the IMPORT ABSTRACT task Please note the IMPORT can execute on a single server If the Verifier and Purge are to be run on servers other than those running the Queue Processor tasks a BP Server must be configured for those servers When PREFET is added to the VistA Imaging display workstation configuration this activity must be checked on the BP Server configuration window in order to have these queue types processed A directory can be created on the RAID shares or remote storage location to archive BP log files for later reference January 2012 Background Processor User Manual Rev 10 9 VistA Imaging MAG 3 0 121 2 5 2 Adding BP Server to the VistA Imaging System Most sites will find that a single BP Server provides adequate performance however the product does provide the capability for adding additional BP Servers Adding additional BP Servers will improve performance by allowing the distribution of tasks among the newly assigned BP Servers To set up a BP Server application 1 From the Windows Start gt Programs menu select VistA Imaging Programs gt Background Processor gt Queue Processor 2 Enter the Access Verify code for the BP account with the VistA security properties listed in section 2 3 2 VistA Security The BP Queue Processor application window opens Site Queue Processor 9 01 30
29. Start Time Start time of purge Run Time Time to complete the purge hrs mins secs Total Files Number of files checked JB Queues Number of files that were purge candidates but not found on the archive jukebox A JUKEBOX queue entry was created to copy the file to the archive The file is not deleted Purge Site Parameters Site File Prefix DM Namespace and multi namespace names for the site IE QRT Abstract keep days Purge parameter indicating the time frame for keeping abstract files on the RAID January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 119 120 Description Full keep days Purge parameter indicating the time frame for keeping Full files on the RAID Big keep days Purge parameter indicating the time frame for keeping BIG files on the RAID Purge Criteria DATE ACCESSED Date criterion used to determine which files to delete Express Purge Indicates if the Express Purge feature was used in this purge Express Purge Term This value is file count The purge will stop on a share when it processes this number of files and none have met the purge criteria to be deleted RAID Share Count Total Share Files Total Abstracts Total number of files traversed on the shares Total number of ABS files found Total Full Total number of Full files found Total Big Total number of B
30. The ScanError log file lists problems with IENs that could not be corrected When a Verifier scan is completed the contents of this file are sent as a mail message to the MAG SERVER mail group Note Action is required to correct any problems listed in this file Guidelines on Handling Errors The most important columns are FULL_JB_PTR and BIG_JB_PTR shown below which display the files that are on the jukebox there is not always a BIG file with an image Important The FULL ABS BIG and TXT files should reside on the jukebox The Message column describes the errors See section 8 3 7 Start Run for the complete list of messages in the Troubleshooting chapter e All file types in a set may not be on the image shares as some may have been purged e If the Check Text option was used see Check Text Option Messages These are potential problems that need to be corrected Date Hme Message IMAGE_PTR FILE NAME FULL JB JB PTR FULL VC ABS VC BIG Current Write JB ALT 1 8 18 2009 3 47 51 ve 1 000003 5 2 2 8 18 2009 3 47 51 TU cite 3 IEO00003 ABS 2 PM 8 18 2009 3 47 51 Not Certed 000003 5 2 18 2009 3 47 51 4 IEO00004 758 2 PM 8 18 2009 3 47 51 Not Certed 4 000004 756 2 8 18 2009 3 47
31. VistA Display Workstations JUKEBOX Queue VistA Imaging Shares RAID January 2012 Background Processor User Manual Rev 10 6 VistA Imaging MAG 3 0 121 62 DELETE removes images from the VistA Imaging shares DELETE queue is set when an end user who has the MAG DELETE security key selects an image to be deleted in the Clinical Display software Typically these are images that are of poor quality or saved against the wrong patient DELETE Queue VistA Display Workstations add a request to the DELETE queue to remove any image files from the VistA Imaging shares that are poor in quality or contain the incorrect identity of a patient After a copy of the image file is verified on the Jukebox the file is deleted from the VistA Imaging shares The verification process of the image on the Jukebox will create a JUKEBOX copy if not currently on the Jukebox Note Users must have a MAG DELETE security key VistA Display Workstations 5 DELETE VistA Imaging Shares RAID GCC generic carbon copy copies images to specified remote locations GCC Queue Capture applications such as VistA Imaging Clinical Capture can add a request to the Generic Carbon Copy GCC queue to export images to a Windows share on an external commercial system VistA Capture Applications Generic Carbon Copy Queue VistA Imaging Shares RAID lt Share Location Background Proces
32. VistA Imaging MAG 3 0 121 Chapter 1 Introduction 1 1 What is the Background Processor The VistA Imaging System is an extension to the Veterans Health Information System Technology Architecture VistA hospital information system that captures clinical images scanned documents motion images and other non textual data files and makes them part of the patient s electronic medical record The VistA Imaging Background Processor hereafter referred to as the Background Processor or BP is a component in the VistA Imaging System The BP runs on a Windows file server The Background Processor ensures the archiving of DICOM and clinical images from short term storage RAID groups onto the archive device a jukebox for long term storage These images are stored indefinitely on the archive device 1 1 1 Background Processor Applications The Background Processor actually consists of three applications e BP Queue Processor The Queue Processor moves image data between RAID and an archive device or remote location e BP Verifier The Verifier maintains location integrity and checks data integrity between the VistA database and the storage media e BP Purge The Purge removes image files from the RAID Image shares based on file dates The combination of these applications ensures that users can access the images for display and analysis in an efficient and timely manner Each application is explained in the chapters that follow Januar
33. date accessed date modified date created to purge the shares There have been instances where third party utilities have changed the access dates on all the files it touched to the same recent date When the purge is activated no files are deleted as none of the file access dates are purge candidates It is recommended that the Date Modified be used This date is retained when files are moved across storage media and is a reliable date for purging 32 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 3 5 1 5 Running the Scheduled Purge The Scheduled Purge option is used when the Purge is to be run at periodic intervals i e weekends when activity is low at a site or when images are to be kept on RAID for a certain period of time i e yearly removing images older than 5 years The application that runs for the Scheduled Purge is the same as the Manual Purge Reference the Manual Purge above for specific information about the GUI and log files Note Set the Purge Retention Days and Purge By as the Scheduled Purge process uses those parameters 1 Select Edit gt BP Servers 2 Drag the PURGE task to the BP Server where the purge is to be run Best if run on an Imaging server Click OK to close the window 4 Select Edit gt Purge Verifier RG Settings tab Set the following fields Field Setting Auto Purge Unchecked Express Purge Active Checked Schedule
34. overall guidelines 15 mail groups 24 mail messages 22 site parameters 16 Conflicting AP amp Image DFNs 88 Conflicting GP and GO DFN 89 Current Write 98 100 CWL 95 0 DELETE queue 12 62 Deleting queues See Purging queues DFN Mismatches in AP Image Mult 89 DFN 1 101 DFN 2 101 DFNError log file 101 Diagram Annotation tool 51 Diagrams annotation 43 in Network Location Manager 43 storage type 51 DICOM Gateway BP Server processing 63 EVAL queue 63 January 2012 Background Processor User Manual Rev 10 158 VistA Imaging MAG 3 0 121 full and abstract files 30 Interface Switch Update 21 PAC files 144 Write Location 21 Domain in adding mail groups 25 E EKG in network location 43 strips for viewing 43 strips from local and remote MUSE servers 49 where data is stored 49 Email messages Ad Hoc Image Site Usage 71 Application process failure 71 Auto RAID group purge 72 GCC Copy Error 72 Get Next RAID Group failure 72 Image Cache Critically Low 73 Image File Size Variance 73 Imaging Integrity Check 103 Imaging Site Verification Issue 103 INSTALLATION 74 listing 70 Monthly Image Site Usage 74 Photo ID Action 75 Scheduled Purge Failure 75 Scheduled RAID Group Advance Failure 75 Scheduled Verifier Failure 76 Site Report Task Was Restarted 76 Verifier Scan Error log 104 VI BP Eval Queue 76 VI BP Queue Processor Failure 7
35. secondary jukebox Check file existence permissions Create Process failed Could not create process on VistA for Verifier Check Error Trap Empty FBIG node FBIG node has no pointers set in 2005 record Check shares for existence of BIG file If not found restore BIG file from backup tapes File of size zero created then deleted Abstract file created of size zero Then it is deleted Likely corruption of BIG and or TGA file None FULL Aggregate Failed Could not copy FULL file from Check file existence permissions secondary jukebox FULL Aggregate Failed Could not copy FULL file from Check file existence permissions secondary jukebox Images JB share is OFF LINE jukebox is offline Set jukebox back ONLINE Make AbstractError Abstract file could not be created from TGA BIG BIG TGA not found or image file corruption Check shares for existence of BIG TGA file If not found restore BIG TGA file from backup tapes New Abs to CWL An abstract file has been created None and copied to the current write image share No ABS file VC Ptr Cleared Abstract file not found on the None Image share No ABS file VC Share OFF Line Image share is offline at location of abstract file Set share back online and re run Verifier January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 135 136 Message Explanation Action
36. type Those extensions not listed must be resent recaptured from the source Missing file Create from master 756 BIG BM BW DCM JPG PAC TGA e TIF Abstract TGA e BIG e DCM For sites that use multiple online archive devices jukeboxes the process is l When a file in the set of images 15 missing and a master file see table above 15 available on the network the verifier creates the derivative file s and will then copy the complete set on the current jukebox The pointers are updated in VistA to reflect this location change January 2012 Background Processor User Manual Rev 10 87 VistA Imaging MAG 3 0 121 3 Patient data integrity checks are automatically performed on the IENs as the pointers are being examined and validated There are 14 integrity checks Any inconsistencies found are reported 5 41 Reasons for Running the Verifier The following scenarios have happened at the sites and are stated here as justification for running the Verifier on a regular basis l 5 5 Each day images are saved on the VistA Imaging RAID shares and jukebox There are occasions when an undetected problem occurs and a file in an image set is not copied to the RAID archive device The Verifier will report these missing files If done in a timely manner missing files can be recaptured resent from the source before they are removed from those sources In cases where image storage application did not comple
37. 2 7 5 During upgrades and file server malfunctions that result in the loss of connectivity to all VistA Imaging shares or to all jukebox devices When jukebox maladies occur such as configuration management tool outages jammed picker arms or shortages of newly formatted platters Daily Monitoring Make sure the BP Server Monitor is running in the background in TaskMan If BP Monitor is not used verify queue entries are being processed Monitor email for alerts that were set up through the application Check Queue Manager for any failed JUKEBOX IMPORT JBTOHD or GCC entries that need to be re queued Run the Verifier daily or weekly over the range of images that were processed in that time period This can be scheduled to run for your chosen interval Examine the Verifier log file No_Archive log for entries with a blank in the 2005 1 column These files missing on your Imaging system RAID and archive storage Monitoring the BP Verifier Verifier scans can be run any time of the day as there is minimal impact on VistA They should be run based on the following reasons 126 Routine Scanning Of Newly Acquired Images The Verifier should be run every or 2 weeks to verify new entries in the IMAGE file 2005 In some cases if images are missing they can be resent from the modality Periodic Maintenance of the VistA Imaging System The Verifier should be run several times each year to verify the entire range of Imag
38. 2009 sos A new logfile is crea PM ted CAProgram Files VistAmagingBakProc logiwerifie Certed Log 8 18 2009 3 42 35 InitLogFile new logfile is created C Program Files VistA lmaging BackP rocilogWwerifienScanError Log 8 18 2009 3 42 35 InitLogFile A new logfile is created C Program FilestVistAMlmaging BackP rocilogwerifieNoArchive Log 8 18 2009 3 42 35 Aggregate Function Enabled PM 9 18 2009 3 44 15 Aggregate 6 756 ABS TXT 2 1 000002 756 5 758 5 1 5 756 1 5 756 2 Description Date Time Actual time when the IMAGE record was processed Message Description of action taken IMAGE_PTR Image record currently being processed including the version dates log file names Filename for the Image record FULL_JB_PTR The DISK amp VOLUME WORM 2 2 value for the archive jukebox share in the IMAGE file 2005 and or IMAGE AUDIT file 2005 1 where FULL image is located Other extensions will be listed here except the BIG file listed in the JB BIG column BIG JB PTR The BIG JUKEBOX PATH 103 value for the archive jukebox share in the IMAGE file 2005 and or IMAGE AUDIT file 2005 1 where BIG image is located The extensions of all files on the jukebox will be listed FULL VC PTR The DISK amp VOLUME MAGNETIC 42 value for the share in the IMAGE f
39. 31 3 RESCINDED IMAGE FILE SERVER1 IMAGE1 SLA0 00 00 02 05 SLA00000020542 TIF H he preceding array was generated by ct he VistA Imaging Import API while processing a RESCIND Image action Enter message action in IN basket Ignore January 2012 Background Processor User Manual Rev 10 TI VistA Imaging MAG 3 0 121 4 6 2 18 Watermarking Failed The following is example of the email message generated when an image associated with a Rescinded Advance Directive cannot be watermarked with the text Rescinded Subj Import API Report 31341 06 23 11 09 52 9 lines From PROVIDER ONE basket Page 1 0 O Image is already Rescinded 1 Image 1 0 lt error message for Rescind Failure 2 1 RESCIND Action is Canceled 3 Image 1 IEN 20924 4 TIU Note 697 The preceding array was generated by the VistA Imaging Import API while processing a RESCIND Image action Enter message action in IN basket Ignore 4 6 3 Screen Generated Output 4 6 3 1 Server Size This window shows the amount of total space free space and Server Reserve space for RAID and jukebox shares as well as RAID Groups Select View gt Server Size from the menu bar to view this window Note This option can be accessed at any time the Queue Processor is running 78 Background Processor User Manual Rev 10 Jan
40. 31199 10 27 09 12 55 4 lines From VistA Imaging basket Page 1 New SLEE IMGxxx MED VA GOV DATE Oct 27 2009 12 55 51 SALT LAKE CITY implementation of VistA Imaging has failed to start the schedule Purge activity The task is currently assigned to BP Server Auto Purge is not currently assigned Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 6 6 3 Screen Generated Output When the Purge completes or you click the Stop button the results are displayed in a summary window You can print to file to save this data 6 6 3 1 Purge Results PurgeResults Manual Purge Run Summary Start Date 8 26 2010 Start Time 11 36 19 4M Run Time 0 0 9 JB Queues 0 Purge Site Parameters Site File Prefix DM GO IE Abstract keep days 1800 Full keep days 1800 Big keep days 1800 Photo ID keep days 1800 Purge Criteria DATE MODIFIED ExpressPurge OFF RAID Share Count Total Share Files 21 Total Abstracts 7 Total Full 7 Total Big 0 Total Text 7 Photo ID 0 Foreign 0 Purge File Count Total Share Files Deleted 18 Purged Abstracts 6 Purged Full 6 Purged Big 0 Purged Text 6 Purged Photo ID 0 Purged Foreign 0 RAID Shares Purged WVHAISWIMGYVMS 400 IMAGEBS Purged Name Description Purge Run Summary Start Date Start date of purge
41. 508 Mode from the menu bar to view this option 84 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 85 Chapter 5 Verifier e Application Description e Setting up e Tasking e Understanding Processing Starting Running the application e Reports 51 Application Description The Verifier validates the VistA Imaging network file references and consolidates jukebox image files It is used to identify and in some cases correct inconsistencies within the VistA database as well as identify incorrect image file locations in VistA Specifically the Verifier e Performs multiple patient integrity checks e Sets or clears invalid file location pointers in the database e Checks for mismatches between image file contents and the database e Checks for mismatches between specific fields in the text files and the database e Re creates missing file types when possible 52 Up the Verifier The Verifier software needs to be installed on a Server class machine The Verifier requires a BP Server defined for the server on which it will run section 2 5 2 Adding a BP Server to the VistA Imaging System In addition the Broker port connection needs to be configured See Appendix A for configuration information Check the network connections to the RAID shares and archive device shares to make sure they are online an
42. 51 5 1 000005 756 2 Description Date Time Actual time when the IMAGE record was processed Message Description of problem IMAGE_PTR IMAGE record currently being processed 100 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 Description FILE_NAME Filename for the current IMAGE file 2005 record being processed FULL_JB_PTR The DISK amp VOLUME WORM 2 2 value for the archive jukebox share in the IMAGE file 2005 and or IMAGE AUDIT file 2005 1 where FULL image is located Other extensions will be listed here except the BIG file It is listed in the JB Big column BIG_JB_PTR The BIG JUKEBOX PATH 103 value for the archive jukebox share in the IMAGE file 2005 and or IMAGE AUDIT file 2005 1 where BIG image is located The extensions of all files on the archive jukebox will be listed FULL VC PTR The DISK amp VOLUME MAGNETIC 2 value for the share in the IMAGE file 2005 and or in IMAGE AUDIT file 2005 1 where FULL image is located Other file extensions that are on this share are listed also ABS VC PTR BIG VC PTR Current Write PTR The DISK amp VOLUME ABSTRACT 22 1 value for the share in the IMAGE file 2005 and or IMAGE AUDIT file 2005 1 where abstract image is located Other file extensions on this share are also listed The BIG MAGNETIC PATH 4102 value for the share in the
43. 70 MAG SYSTEM security key 8 9 20 25 MAG WINDOWS secondary menu option 8 20 64 MAG WINDOWS security key 9 MAG type of storage 65 MagBPSetup exe 7 Magbtm exe 7 MagbDexter utility description of 6 MAGEVAL 122 122 MagKat utility description of 6 MAGMIN 122 MAGnH 43 MagPurge exe 7 MAGQ BPMONITOR 76 122 MAGQ BPMONITOR menu option 76 MagUtility utility description of 6 MagVerifier exe 7 Mail groups adding members 25 adding remote members 26 configuring 24 deleting members 26 displaying lists of users 25 domain 25 guidelines for adding 25 MAG SERVER 70 MEMBERS REMOTE 70 specifying properties 26 Mail messages 22 adding names 23 configuring 22 displaying lists of users 22 fields descriptions 23 notification intervals 23 removing names 23 transmission frequency 23 MEMBERS REMOTE 70 Memo 102 Mismatches 85 Missing files Verifier 86 Missing Group Objects 89 Monthly Image Site Usage message 74 MUSE default site number 19 EKG 49 locations on EKG tab 49 remote GE Muse server 43 server 49 setting for site location 17 site 49 version 49 N Namespace 17 NameSpace multiple 19 Network bandwidth 7 Network configuration 2 Network connection troubleshooting 127 160 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 Network Location Manager adding a new
44. Check Text Files check box The contents of the text files on RAID will be compared to the information in VistA This processing will slow down the Verifier processing and utilities are not available at the present time to correct any issues that surface e The Last Verifier Date field is set by the system and cannot be set by the user e When the Active parameter is checked the Frequency in days field setting should be 1 so that the Verifier runs daily e Initially set the Next Verifier Date to today s date The scheduling frequency will be based on this date e Set the Verifier Time to an inactive period of the day typically after hours when image creation activity is low 3 5 2 3 Running the Scheduled Verifier Use the following steps to schedule the Verifier 1 Select Edit gt BP Servers 2 Drag the SCHEDULED VERIFIER task to the BP Server where the verifier is to be run 3 Click OK to close the window 4 Select Edit Purge Verifier RG Settings tab 5 Setthe following fields in the Scheduled Verifier box Field Setting Active Checked Check Text Files Unchecked Frequency in days 1 Next Verifier Date starting date Verifier Time time of day the Verifier will run after hours is best 6 Click OK to close the window 7 Click Start on the Queue Processor main window The Queue Processor must be in the running state in order for the Scheduled Verifier to run on the designated server
45. Edit gt BP Servers 2 In the tree pane right click the server name and select Delete BP Server from the popup menu displayed Note This popup menu can also be accessed from the keyboard by using Shift F10 Background Processor Servers 4 p Delete BP Server d Server Properties e SAF Unassigned Tasks The selected BP Server is removed from the tree pane Note This same name can be added later 2 5 5 Specifying the Log File Location and Size 1 Click a BP Server name in the tree pane and select Server Properties from the popup menu displayed Note This popup menu can also be accessed from the keyboard by using Shift F10 Background Processor Servers 9 0 Unassigned Tasks The BP Server Properties dialog box is displayed BP Server Properties x Client Executable Version 30 1 3923 Client Distribution Date DEC 23 2009 05 Win Server 5 2 3790 Last Execution Date MAR 11 2010 Log file Size Network Log file location Cancel 2 Enter the size megabytes in the Log File Size field The default log file size limit is 2 MB 3 Specify the Network Log file location on a local machine or a remote network location Note By default the log files are created on the local drive in the directory Program Files VistA Imaging BackProc Log If a remote network location is entered the Background
46. Future utility patch 8 3 3 Integrity Messages on Patient Data There are integrity issues that will prevent their respective images from being displayed and others that will not impact the viewing See Appendix C for sample output 8 3 3 1 Conditions Preventing Viewing An integrity error message will be generated when the image is retrieved for viewing on these conditions and the patient image will not be viewable until the condition is corrected or the user has the proper key to view these images Message Explanation Action No Image Ptr in AP The Clinical Association Report AP for this image does not contain an image entry that points back to this image Future utility patch GP has no images Image series that does not contain any images Group Parents GP are containers for an Image series A group parent with NO group objects GO is an invalid condition Future utility patch Conflicting AP amp Image DFNs The patient file reference DFN in the Clinical Association Report AP does not match the DEN in the IMAGE file 2005 Future utility patch Invalid Image Ptr to AP Conflicting GP and GO DEN The Clinical Association Report AP has image references that are not in the IMAGE file 2005 The patient file reference DFN in the Group Parent GP is not the same as the in the Image entry Future utility patch Future utility patch Jan
47. January 2012 Term Definition DICOM Acronym for Digital Imaging and Communications in Medicine a protocol for sharing and viewing medical images DICOM has traditionally been used for radiology images and recently has been used for images in other specialties such as cardiology dental gastrointestinal endoscopy and ophthalmology Directory hashing Process of storing files in multiple subdirectories based on the filename as follows Ifhashing is used files are maintained in a 5 level deep subdirectory structure where no directory will contain more than 100 unique filenames with their various extensions e If hashing is not used files are placed and retrieved from the root directory of the share VistA Imaging recommends using hashing File In the VistA database the equivalent of a database table as well as a file in the generic sense File types In VistA Imaging ABS Abstract or thumbnail image file BIG Large image file that takes up a lot of storage space FULL Full size full resolution image file TXT Site specific installation or setting file Hash See Directory Hashing HIS Acronym for hospital information system which is a comprehensive integrated information system designed to manage a hospital s administrative financial and clinical information related to patient data electronic patient records IEN Acronym for Internal Entry Number IMAGE file File in the Vi
48. Leave the Operational Status check box selected by default setting or clear it 8 Leave the Read Only check box cleared by default setting or select it 52 Click Apply to add the changes to the database or click OK to add the changes and exit Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 3 7 3 Editing the Properties of a Network Location To edit the properties of a network location right click the entry and select Properties on the pop up menu Note This popup menu can also be accessed from the keyboard by using Shift F10 JUKEBOX GOC tro URU HASH SUBDIRECTORY Network Location Properties PIGRI Share Name MAG2N Network Share WHAVHAIMGVMS404 IMAGE 2 TA X coca po 1 From the Queue Processor menu bar select Edit gt Network Location Manager and select the appropriate tab 2 Right click a row in a table grid and select Properties from the popup menu displayed above Note only the properties applicable to the selected Storage Type are editable The Network Location Properties dialog box is displayed The Share Name and Network Share are displayed based on your selection January 2012 Background Processor User Manual Rev 10 53 VistA Imaging MAG 3 0 121 site Network Location Properties Cache IDs m Share MAG2H Storage w Network Share MAGNETIC
49. Message type drag the name from one of the windows on the right to the Mail Message Manager window on the left The change will be stored in VistA when the name is dropped into the Mail Message category You can add as many names as needed to each Mail Message on the left 3 31 3 Removing Names When a user no longer wishes to receive a specific warning alert the user s name can be removed from that particular message list at any time VistA will be automatically updated to reflect the change 1 Locate the warning alert message and right click the username under the message title 2 Select Delete from the popup menu displayed VistA will automatically be updated to reflect the change 3 3 1 4 Notification Intervals The mail messages are sent out to the designated users at specific intervals default is 6 hours These intervals can be adjusted per message name To change a notification interval for a particular Mail Message follow the steps below Mail Message Properties Application process failure Transmission frequency in hours Last Message OK Cancel 1 Right click a message name and select Properties from the popup menu displayed 2 Change the Transmission frequency in hours to the new value Click OK to close the window VistA will automatically be updated to reflect the change 3 3 1 5 Field Descriptions The fields for the Mail Message Manager are described below Field Des
50. Purge Criteria DATE CREATED IEN Count 0 SORES Site File Prefix CHADM SLO XX Abstract keep days 99999 Full keep days 79009 Big keep days 99999 Photo ID keep days 99999 Minimum keep days 79009 Purge Criteria DATE CREATED Express Purge ON Express Purge Rate 10000 Original File Counts 45 Abstract Big Text Photo ID Foreign Purged Files Name Description Purged Files Date Last Accessed List of files on the current RAID share highlighted in the Share Processing window that are deleted because they met the Purge criteria Activities Start Date Start date of purge Start Time Start time of purge Run Time hrs mins secs Time to complete the purge Total Files Purge Count Number of files checked Number of files purged JB Queues Number of files that were purge candidates but not found on the archive jukebox A JUKEBOX queue entry was created to copy the file to the archive The file is not deleted Purge Criteria DATE ACCESSED Date criterion used to determine which files to delete January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 113 114 Description IEN Count Number of unpurged IENs traversed since the last IEN purged on the current share When the Purge operation is traversing through an IEN ra
51. Version Description Software version and build number C Program Files VistA Imaging BackProc Magbtm exe Location of the Background Processor executable on your hard drive 2067 KB date File size and date of executable Mag_MakeAbs exe Executable and version number of the ABSTRACT queue used to create the abstracts thumbnails of images System Installations Version and installation date of Imaging patches Note The latest patch is listed at the bottom January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 67 4 6 Reports Three types of output are produced to notify users of important occurrences e Log files e Emails e Screen generated output 4 6 1 Log Files New log files are created as HTML files at the beginning of every session HTML files are viewable printable and searchable By default the BP Queue Processor log files reside in the C Program Files VistA Imaging BackProc log BackProc directory You can access these files by e Selecting File gt Open Log on the BP Queue Processor menu bar e Using an internet browser Note The log files can be imported into an Excel spreadsheet Important These files should be kept for historical troubleshooting reasons and added to the tape backup process to safeguard the files See Appendix Backups in the Vista Imaging System Installation Guide Log File Format BP Queue Processor log fil
52. also be accessed from the keyboard by using Shift F10 File Types File extensions outside of the standard extensions that the BP products will recognize and treat as a standard extension file Note Right clicking this field displays an Add Delete popup menu that can also be accessed from the keyboard by using Shift F10 3 2 1 3 Clinical Workstation Settings Clinical Workstation Use Capture Keys Timeout Windows Display E 20 Timeout Windows Capture 20 Timeout Vist4Rad Default MUSE Site Default User Preference user SETTING 1 gt Field or Checkbox Description Use Capture Keys Check users Imaging security keys for permission to capture images Timeout Windows Display Timeout Windows Capture Timeout VistARad Default MUSE Site Default User Preference Number of minutes until the Imaging Display application will close due to inactivity The default setting is 120 minutes Range 6 to 600 Number of minutes until the Imaging Capture application will close due to inactivity The default setting is 120 minutes Range 6 to 600 Number of minutes until the Imaging VistARad application will close due to inactivity There is no default setting MUSE site number that the Imaging Display application will connect to Site numbers are usually 1 2 3 If left empty the field defaults to 1 A specified user s parameter settings will
53. and are named e Magbtm exe Queue Processor e MagVerifier exe Verifier e MagPurge exe Purge 2 2 Hardware Requirements 20 local disk space minimum e minimum e Server class machine The BP can be run on Image servers However the Schedule and Auto events Verifier amp Purge only execute on a Server class machine e 100MB sec network bandwidth or better Local archive device jukebox when possible January 2012 Background Processor User Manual Rev 10 7 VistA Imaging MAG 3 0 121 2 3 Setup Requirements There are some initial checks that must be done on the server client where the BP will run and on the VistA system where Cach will exist The following sections describe the setup requirements on each platform 2 31 Windows Security Use the established Windows Imaging Administrator VHAxxxIA account for accessing the Background Processor The Imaging Administrator account is a domain account that has READ WRITE permissions to the Imaging RAID and archive shares This account will be used to log into the BP Server Remote IMPORT share permissions must match the Windows OS login on the server running the BP software Remote EXPORT share permissions must match the Windows OS login on the server running the BP software The Imaging Administrator account is a domain account that has READ WRITE share folder file permissions on the Imaging RAID shares and archive shares see t
54. can be run manually in standalone mode or as a part of the Queue Processor The Purge Parameters are used to control the purge activities in auto manual and scheduled modes 3 5 1 1 Guidelines for Setting Retention Days on Files for the Purge General guidelines e Determine the span of dates of images that will be preserved on the Imaging shares The shorter the timeframe the more space will be free on the disk when the purge completes e Multiple purges may be required to determine the retention days It is advisable to start with one share with a large retention days value Not all sites capture all the file types specified in the parameter list e If the frequency and the results of purging are acceptable then it is not advisable to change the Purge values e If there is still not enough free space after the purge decrease the Purge Parameters BIG and FULL files in particular and repeat the purge until the desired free space is obtained Factors that determine the best set of purge parameters for an individual site are e The frequency of purges e The volume of image acquisition rate e The volume of image file retrieval The use of Pre Fetch The capacity of disk space for VistA Imaging shares Some sites have extended their RAID capacities and are able to maintain five or more years of images on the shares These sites may only need to purge once per year to purge off the latest year of images year 6 Others who have
55. computer or telecommunications system as the Internet Acronym for Picture Archiving and Communication System If a site has integrated a commercially available PACS with VistA Imaging images from that PACS are treated in a manner similar to images produced by modalities such as a CT or MR One of the three applications in the Background Processor used to process the removal of files from RAID shares when the last access date exceeds the age specification within the local site parameters The purge process will not delete a file if it cannot locate a copy of that file on the archive If such a file is detected purge will create a JUKEBOX queue entry for that file See also Verifier and Queue Processor Queue A request by the VistA Imaging System to create move or delete a clinical image file for the purpose of system efficiency Queue pointer Database file reference to the next queue to be processed within the queue file Queue Processor One of the three applications in the Background Processor used to handle requests by the VistA Imaging System to manage clinical image files for the purpose of system efficiency Managing the files involves processing multiple queues tasks See also Verifier and Purge RAID or RAID Acronym for Redundant Array of Inexpensive Disks the primary shares storage area for recently acquired and recently accessed clinical images Also the term used to identify a specific type of Netwo
56. displayed using the tabs and are described in the table Function Description RAID RAID shares on the Imaging server cluster Note Use MAGnH names for these shares is a unique number indicates the file directory structure is hashed JUKEBOX Cache shares on the archive device jukebox Archive Appliance Note Use WORMOTGnH names for these shares is a unique number H indicates that the file directory structure is hashed Routers Network shares on remote servers desktops where new images are transmitted using the Imaging AutoRouter product Security Access to these locations requires a Windows Username and Password Note Use meaningful names as these names are used in the routing rules file ROUTE DIC on the routing gateways GCC External network shares where images can be transferred for non VistA Imaging usage Security Access to these locations requires a Windows Username and Password EKG Remote GE Muse server share locations where the Electrocardiograms are stored The EKG strips can be viewed from these remote locations using the Clinical Display software Security Access to these locations requires a Windows Username and Password URLs Remote Image Views is a feature of the Clinical Display software that allows users to view patient images from any VA hospital in the country These images are processed through a web service on remote server The URL for
57. fields in the IMAGE file 2005 in the VistA database using data from the text files associated with images e MagUtility used to report and resolve problems with orphan files delete obsolete or incorrect entries from the NETWORK LOCATION file 2005 2 update the VistA database with image information and copy images and text files For details see the Storage Utilities User Manual 6 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 Chapter 2 Setting Up Your BP System e Software Requirements e Hardware Requirements e Setup Requirements Security e Installing the BP software e Configuring BP Servers This chapter provides all the steps necessary to set up your Background Processor system Note Configuration information that applies to site requirements is explained in Chapter 3 Configuring the Application 2 1 Software Requirements The Background Processor software MagBPSetup exe is distributed with the VistA Imaging system Three components are included in this file the Queue Processor the Verifier and the Purge software The Background Processor software presumes the presence of the proper Imaging KIDS package installed on VistA Refer to the most recent Imaging Patch Description for the Background Processor for compatibility information Once they are installed the executables for the Background Processor applications are located in the Program Files Vista Imaging BackProc directory
58. files can be lengthy with no files being deleted in the process Some sites have a large number of shares and this dead time for purging can be extreme The Express option causes the Purge to stop the file traversal on a share when the number of consecutive files that have not been deleted is greater than the Purge Rate measured in file count The three ways to initiate a purge are e Auto The application monitors the amount of free space on the current RAID Group and determines if there are multiple RAID Groups If only one RAID Group exists when all the shares have reached the high water mark indicated by the Server Reserve a purge is initiated on all the shares If multiple RAID Groups are present and all the shares in the next RAID Group are above the high water mark the purge on that next RAID Group will start when the free space on the current RAID Group falls below the Server 108 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 Reserve times the Purge Factor The Purge Factor is whole number and is set to a value that allows enough time for the Purge to complete on the next RAID Group before the application moves the current write location to that group It is recommended that the Express Purge option be set on the Auto Purge These parameters are specified on the Imaging Site Parameters window Note A BP Server must be assigned the PURGE task to run the Auto Purge e Scheduled The Pu
59. folders files on those shares Note For sites using the Archive Appliance AA contact the HP Expert Center Open a DOS window At the command prompt type dir server share the server could be a cluster server or the jukebox server Traverse down a couple folders under the main level the folders files should be visible If any of these methods fail open a DOS window and use the DOS ping command to see if the server is accessible on the network If the server is accessible try mapping the share thru Windows Explorer Explorer will display any error messages If the server is not accessible contact the network admin to troubleshoot January 2012 Background Processor User Manual Rev 10 128 VistA Imaging MAG 3 0 121 8 1 2 Broker Failures When the connection to the Broker fails e Verify the PORT and Server are correct in the registry e Close and restart the application Open a DOS window and use the ping command to see if the VistA server is available e Verify that the listener is running in VistA e Validate that the Access Verify codes have not expired e Check the security on the Access Verify account Make sure The MAG SYSTEM security key is assigned The MAG WINDOWS menu option is assigned 8 1 3 Not Enough Server Cache This message indicates that e The share on the server is not accessible Follow the steps in section 8 Network Connection to troubleshoot e The free space on the Image shares is b
60. is stored Note Use names to reflect the type of transfer for these shares IEN The record number in VistA for this Network Location PHYSICAL REFERENCE The UNC Universal Naming Convention containing the MUSE server and share name OPERATIONAL STATUS Logical state of the share or OFFLINE STORAGE TYPE MUSE EKG MUSE SITE MUSE EKG network location number Typically a site with a single MUSE server that holds EKGs for one site would use 1 MUSE VERSION MUSE software version January 2012 Background Processor User Manual Rev 10 49 VistA Imaging MAG 3 0 121 3 7 1 6 URLs Tab The Remote Image Views functionality in the Clinical Display application uses a Network Location entry that points to the VistA Site Service to determine the server and port of remote VistA databases This Network Location entry is a WEB service running on a centralized accessible server on the network To edit the properties of a network location right click the entry and select Properties on the pop up menu Note This popup menu can also be accessed from the keyboard by using Shift F10 RAD JUKEBOX Rowers GCC EKG URLs Diogroms Cache Share Nome 5 Surge Type Network Share SERVER VISTA MED GOVMS Eus ms vo xo See Field Description NETWORK LOC ATION The name of this WEB ser Vice Note suggested name VIST
61. no network location references for this image DM000734 TGA 10 8 2009 10 03 05 AM JUKEBOX 142 There are no network location references for this image DM000733 TGA 10 8 2009 10 03 04 AM JUKEBOX 1 41 There no network location references for this image DM000732 TGA 10 8 2009 10 03 03 AM JUKEBOX 140 There no network location references for this image DM000731 TGA 10 8 2009 10 03 02 AM Jukebox 139 Jukebox copy not overwritten 10 8 2009 10 03 02 AM Jukebox 139 0 00 07 0 000729 WHAISWWHITEYM1 IMAGEJB1S L 10 8 2009 10 03 02 AM JUKEBOX 139 TXT Not copied 10 8 2009 10 03 02 AM JUKEBOX 139 WHAISWWHITEVM1 IMAGE1 DM 00 07 DM000729 TXT WHAISWWHITEYM1 IMAGEJB1 Name Description VistA Storage Network Location Name Name of the entry in the NETWORK LOCATION file Storage Type Types of storage MAG Magnetic RAID share WORM OTG Write Once Read Many archive device RAID Group RAID share group Note These types are also defined in the Network Location Properties dialog box IEN Internal Entry Number in the NETWORK LOCATION file for the Storage Type device Free Space Disk free space available in megabytes Disk Size Disk space capacity in megabytes Share Path UNC path of the share RAID Group RAID share group name Queue Activity box Queue Name of the queue identifying the task being processed January
62. on RAID Set RAID pointer No purge 8 Jukebox pointer set File on jukebox RAID pointer set File on RAID Purge file 9 Record not in the IMAGE file 2005 No Purge 10 File extension is not a valid Imaging file extension No Purge 14 Duplicate 2005 2005 1 entry No Purge 15 Foreign PLACE No Purge 16 Record only in Audit 2005 1 file No Purge 17 Jukebox offline No Purge TXT extension only 1 AltLastFile Last file on the share No Full ABS or BIG file present on share Purge file 6 5 Starting Running the Purge The Purge can be started as an independent application can be configured to run automatically in the background see section 3 5 7 Purge Settings or can be scheduled to run in the background at prescribed time intervals see section 5 5 7 Purge Settings The following steps describe how to run the Purge in the foreground Note The Purge Retention Days and Purge By file dates are used by all the options listed below Set these parameters before any of the Purge options are run scheduled 1 From the Windows Start gt Programs menu select VistA Imaging Programs gt Background Processor gt Purge 2 Log into the application using a valid VistA access and verify code The secondary menu option MAG WINDOWS is required for access to the Verifier 110 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 The Purge application window opens
63. point the purge displays a summary page indicating its processing is complete for this session 6 4 1 Setting Purge Parameters Typically the Abstract file parameter is set an equivalent of 5 years in days These files are small in size and are viewed as thumbnails on the Clinical Display workstations Locating images for a patient is much less time consuming when these images are available on RAID versus having to wait for retrievals from the archive jukebox The keep days for the Full and BIG files should be kept reasonably large to start 1 Starta test run on one share and determine how much free space is available after the run 2 Ifthe free space is adequate use the current parameters to purge the remaining shares 3 f more free space is needed change the FULL and BIG retention keep days to a lower number and start another test run on one share 4 When the right settings have been found start the purge on the other shares These values can be kept in place until the rate of images per day increases substantially At that time the FULL and BIG parameters will have to be decreased to remove more images from the shares January 2012 Background Processor User Manual Rev 10 107 VistA Imaging MAG 3 0 121 Some sites have enough RAID storage to keep 5 years of images These sites need only purge once per year to remove the sixth year s images off the RAID The Purge Parameters can be set to 5 years in days for the Abstract F
64. share to keep the images segregated To edit the properties of a network location right click the entry and select Properties on the pop up menu Note This popup menu can also be accessed from the keyboard by using Shift F10 RAO JUKEBOX Routers EKG URLs Diagrams fA VHAAAAIMMJBTUMAGE 38510 43952 OnLine On Line Field Description NETWORK LOCATION pats of a share on the server containing the archive evice Note Use WORMOTGnH names for these shares is a unique number indicates the file directory structure is hashed The record number VistA for this Network Location PHYSICAL REFERENCE The UNC Universal Naming Convention containing the server and share name for the archive storage TOTAL SPACE Storage capacity for the share FREE SPACE Free space remaining on the share OPERATIONAL STATUS Logical state of the share ONLINE or OFFLINE January 2012 Background Processor User Manual Rev 10 45 VistA Imaging MAG 3 0 121 5 WORM OTG for archive media HASH SUBDIRECTORY A flat or hierarchal folder structure will be created used default is hashed display only 3 7 1 3 Routers Tab Some types of images are routed to remote Radiologists using the VistA Imaging AutoRouting software These images are written to a share on their remote se
65. smaller RAID sets have to purge more frequently and can only have a limited amount of images on their shares For your site strive to keep the shares between 80 and 90 full or between 10 and 20 free space When the Purge process completes and the resulting free space is in excess of this values then adjust the parameters accordingly January 2012 Background Processor User Manual Rev 10 29 VistA Imaging MAG 3 0 121 1 3 5 1 2 Configuring the Retention Days Settings Retention Days Retention Dates Full Files 90 5 15 2003 Big Files 45 6 29 2009 Abstract Files 20 4 15 2009 Photo IDs 89999 10 30 1735 Field or Checkbox Description Retention Days and Retention Dates box Full Files Source Images from the DICOM Gateways Clinical Capture workstations and Imports File extensions 756 ASC AVI BMP BW DCM DOC HTM HTML JPG MHT MHTML MP3 MP4 MPEG MPG PAC PDF RTF TGA TIF WAV Range 0 99 999 number of days back from the current date that files should be retained Big Files Source Images from the DICOM gateway and Clinical Capture workstations File extensions BIG Range 0 99 999 number of days back from the current date that files should be retained Abstract Files Source Images from the DICOM gateways Clinical Capture workstations and Imports Abstract files are derivatives of the TGA BIG format files File extensions ABS Range 0 99 999 number of days b
66. tape backups and monthly quarterly tape backups started on the next current write group 3 5 3 3 Running the Scheduled RAID Group Advance This option is applicable when the there are multiple active RAID Groups 1 Select the Edit gt Purge Verifier RG Settings tab 2 Set the following fields in the Scheduled RAID Group Advance box Field Setting Active Checked Frequency in days Set by determining how long a span of time images will be written to a set of shares in a Group Next Advance Date Set the starting date when the system will move to the next RAID Group Advance Time Set the starting time of day when the system will move to the next RAID Group Click OK to close the window 4 Click Start on the Queue Processor main window The Queue Processor must be in the running state in order for the Scheduled Verifier to run on the designated server 3 6 Queue Manager The Queue Processor is tasked by other Imaging products and external sources to perform various activities with new images emanating from those sources These tasks are placed on a queue structure FIFO with each type of task in VistA These tasks are described in section 2 5 3 Assigning Tasks Queues to a BP Server Note To execute these tasks they must be assigned to a BP Server This can be done using the BP Servers window which is an option on the main BP window 38 Background Processor User Manual Rev 10 January 2012 VistA Imaging MA
67. task can be assigned to any server to change the priority of processing In addition to setting up the task assignments there are various parameters that need to be set up as described in this document January 2012 Background Processor User Manual Rev 10 57 VistA Imaging MAG 3 0 121 e Once the parameters set up the Queue Processor be started to process active queue entries Note The Queue Processor runs without operator intervention and should operate continuously in order to keep pace with the workload It should be monitored daily and it is highly recommended to task the BP Monitor utility For details see Chapter 7 System Monitoring 43 The Queue Processor has set list of tasks that it performs The specific requests for each task originate on the local Queue Processor or from another VistA Imaging product The process is as follows 1 These requests are sent to the VistA database and are stored on FIFO lists called queues 2 The Queue Processor dynamically checks these queues to determine if there is work to be completed When an entry is found the processing is started based on the queue type 4 When the processing is successfully completed the queue count is decremented and the Queue Processor waits for another task to be sent 5 When the processing fails the entry is re queued twice before it is placed on a failed queue for that task Failed IMPORT queues must be manually re queue
68. that is installed does not match the KIDS version installed on VistA Install the correction version of the KIDS and client software The Patch 39 KIDS install on the VistA host system is required for this Version of the site name BP Queue Processor Background Processor User Manual Rev 10 The KIDS file for this most recent patch has not been installed in VistA VistA Imaging MAG 3 0 121 Install the KIDS file on VistA January 2012 Message Explanation Action The Site parameter context could not be determined The application will terminate The PLACE global is corrupt Log a Remedy ticket This server is not yet configured for BP queue task processing There is no BP Server name assigned to this server Create a BP Server through the GUI and assign tasks to it 8 2 2 Runtime Message O Accusoft Control creation error lt error message gt Explanation The Import API uses the AccuSoft Image Gear Toolkit to create the watermarked image If an error occurs during the creation of AccuSoft controls the error message displays describing the error Action The AccuSoft controls are installed during MAG 3 0 121 installation If this error message occurs contact the VistA Imaging system manager You may need to reinstall MAG 3 0 121 to correct AccuSoft ImageGear problems O Image is missing from input data The image to be watermarke
69. this web service is stored here Diagrams Annotation diagrams templates and mark ups are stored at these share locations The Clinical Display software has a tool that can be used to edit and save these marked up diagrams for a patient 37 11 RAID Tab Each site has an Imaging RAID primary where images from the gateways scanners cameras etc are stored for quick access for display on VistARad and Clinical Display workstations This storage resides on the Imaging cluster Shares can have different capacities for storage The physical location for each of these shares is stored under the RAID storage type in the Network Location Manager To edit the properties of a network location right click the entry and select Properties on the pop up menu January 2012 Background Processor User Manual Rev 10 43 VistA Imaging MAG 3 0 121 Note This popup menu can also be accessed from the keyboard by using Shift 10 PAD JUKEBOX Rouen GOC STORAGE HASH SUBDIRECTORY 1331 OH Cache IDs 3913 Share Name MAG2H QR Network Share BKKKKKKK gt WHAVHAIMGYMS 404 2 PHYSICA RE TOTAL SPACE FREE SPACE mmm Mt nire MAGNETIC a Onire MAGNETIC nira MAGNETIC 5 Onire MAGNETIC GIH 50H fsitej Network Location Properties Storage Type MAGNETIC v Operational Status
70. username JOB ID PID 040 Edit Help VistA Storage Stop Background Processor Event Log 3 From Queue Processor menu bar select Edit gt BP Servers Imaging Site Parameters Mail Messages Mail Groups Purge Verifier RG Settings BP Servers Queue Manager Network Location Manager The BP Server Parameters window enables you to create a unique server name for a server and assign tasks to that server The properties on these servers enable you to specify the location of the log files for each application and the file s size limit described in section 2 5 5 Specifying the Log File Location and Size 10 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 inl xl c BP Server Parameters Imaging Site Parameters Mail Messages Mail Groups Purge Verifier RG Settings BP Servers Queue Manager Background Processor Servers 3 o ABSTRACT di SAF 5 4 Unassigned Tasks oa PURGE 99 SCHEDULED VERIFY aj JUKEBOX cj JBTOHD cj PREFET IMPORT GCC 99 DELETE Add NewBP Server Cancel 4 Click the Add New BP Server button at the bottom of the tree pane 5 Inthe BP Server Add dialog box displayed enter a logical name for the BP Server such as BP1 Note The name must be at least three characters in length and can contain alpha and numeric characters and must be unique Once the name is saved it can
71. with the Network Location Manager Import Queue Checks users Imaging security keys for permission to capture Security images Site Code Three letter acronym for the site location This is used for AutoRouting and MUSE Associated This set of institution values will allow users from other Institutions institutions to access local images Note Right clicking this field displays an Add Delete popup menu that can also be accessed from the keyboard by using Shift F10 January 2012 Background Processor User Manual Rev 10 17 VistA Imaging MAG 3 0 121 18 Field Checkbox Description VistARad Grouping The radiologist can lock interpret exams for other divisions including the Parent Institution or other Associated Institutions when those divisions are included in this set of institutions Note that this setting controls exam locking and updating as well as filtering of the UNREAD Exams lists to show only the Institutions that are defined here Note menu that can also be accessed from the keyboard by using Shift F10 Right clicking this field displays an Add Delete popup 3 2 1 2 Storage Functions Settings Storage Functions DM IE Jukebox Write Location Server Reserve Auto Write Location Update Multiple Namespace File Types Field or Checkbox Jukebox Write Location Description Jukebox share where newly a
72. 012 VistA Imaging MAG 3 0 121 3 2 1 5 DICOM Interface Settings DICOM interface DICOM Gateway Write Location DICOM Gateway Interface Switch Update Retention Days HL Modality Worklists 899999 Free Space DICOM Messages 0 Retention Days DICOM Messages fi 5 Field or Checkbox DICOM Gateway Write Location Description RAID share where newly acquired images are currently being written DICOM Gateway Interface Indicates presence of a DICOM Gateway on the system Switch Update Retention Days HL7 This field is used as the default value in days by the Modality Work Lists DICOM Text Gateway for three different user menu driven purges e This field is used by the Purge Old Modality Worklist Entries menu option to determine the number of retention days from the date of creation of Modality Worklist Entries e This field is used by the Purge Old DICOM Message Files menu option to determine the number of retention days from the date of creation of DICOM messages that were sent to commercial PACS e This field is used by the Purge Old HL7 Transaction Global Nodes menu option to determine the number of retention days from the date of creation of HL7 messages sent from VistA to the DICOM Text Gateway Note This value may be overridden by the user when executing any of these menu options Free Space DICOM Minimum percentage of free disk space for DICOM HL7 Messages messages
73. 135 Not Eno sh Server Cache 129 8 1 4 Not Enough Process Memoty 129 8 1 5 Not Enough Write Cache Available 129 8 2 QUCUERIOCESSOFS eA ae EE EC ee SS 130 LEUR Pe P RN 130 8 2 2 RUMUME 131 0 3 BELTIGE S ot 134 S 134 9 32 135 8 3 3 Integrity Messages on Patient 137 8 3 3 1 Conditions Preventing Viewing 137 8 3 3 2 Conditions Allowing Viewing 139 nr ucl EE 139 Appendix A Broker Server Configuration 44 44 4 142 Appendix B File Formats 2 4 etre a sapor tea a vd eva Ya pa Ya ov sp va 144 Appendix C Verifier Integrity eee eren etta 148 Ml C 152 gt 158 January 2012 Background Processor User Manual Rev 10 1 VistA Imaging MAG 3 0 121 Background Processor User Manual Rev 10 January 2012
74. 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 65 4 5 2 Getting Help You can get help from different sources e Queue Processor GUI gt Hovering the cursor over the application window and pressing the key gt Selecting Help from the menu bar e Call customer support at the National Helpdesk Name Description Active Number of active files to be processed Failed Number of files that failed in processing Failed queues should be checked For details see Chapter Troubleshooting BP Event Log log file location Event Time Date and time of the last run of the log Process Queue IEN Queue type queue number and status check info Process Status Source and destination of each file transfer creation or deletion Note Be sure to have the information shown in the example of the table that follows and a copy of the most recent log files About Imaging for Windows 66 Imaging for Windows Washington Office of Information System Design and Development Vista Imaging Version 30 1 39 25 CRC 61199380 C Patch39 Patch39T 25 M agbtm 2527 KB Mag_MakeAbs exe System Installations install Date 2 5P1 2 5P3 2 5P4 2 5P5 08 03 10 5 10 pm DEC 29 2001 DEC 29 2001 DEC 29 2001 DEC 29 2001 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012
75. 5 3 5 2 2 Guidelines for Setting Parameters for the Scheduled Verifier 35 3 5 2 3 Running the Scheduled 36 3 5 3 RAID Group Advance Settings aio ine adt dendi e eade 37 3 5 3 1 Configuring the Scheduled RAID Group Advance Settings 37 3 5 3 2 Parameter Guidelines for the Scheduled RAID Group Advance 38 3 5 33 Running the Scheduled RAID Group 38 Queue WANA 38 3 6 1 Queue Manager Operations 39 3 0 2 Purpits d QUEUE a iet 40 3 6 3 Re Queuing a Failed Image teint 40 3 6 4 Setting Queue Partitions tin an E ed M 41 3 6 5 Accessing Import Queue 41 Network Location Manager 42 3 7 1 Configuring the Network Location 6 43 3 43 3 42 Jukebox 45 46 SAT GCE Tab E 48 3 51 2 EAD icra face 49 Mii o 50 Tab sse 5 3 7 2 Adding a New Location to Network Location Manager
76. 6 PM Purge Criteria 32246 WVHAISWWHITEVMTUIMAGET1 UUMYOYS53DMOD0585 JP G 4 8 2009 8 18 2008 3 20 46 PM AltLastFile WVHAISWAWHIT EVM IMAGE 1 0 20 05 2 000595 4 8 2009 8 18 2008 3 20 46 Purge Criteria 3 1 6 WVHAISWAWHIT EVM IMAGE 1 0 00 05 2 000596 4 8 2009 8 18 2009 3 20 46 PM Purge Criteria 3 2 6 WVHAISWWHITEVMTIMAGET1 3DMYDOY 53DMODO586 JP G 4 8 2009 8 18 2008 3 20 46 PM AltLastF ile WVHAISVIAVHIT E VM IMAGE 1 2 00 05 2 000596 48 2009 8 18 2008 3 20 46 PM Purge Criteria 35 156 WVHAISVAVHITEVMTUIMAGETPDNMYODS3DMOO0597 ABS 4 8 2009 Name Description Date Time Date and Time of purge Event Type Displays the final purge criteria for the file listed See Purge Criteria section Message Image file and access creation or modified date depending on the criteria Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 6 6 1 2 PurgeError Log File The PurgeError html log file records the current share being purged as well as all of the files that were not deleted and the reason they were not deleted The following example shows a copy of the purge results Address C Program Files Vist4 Imaging BackProc log purge PurgeError2009_08_18 html Date Time Event_Type Message DN E InitLogFile A new logfile is crea
77. 7 Error Level 102 EVAL queue 11 63 76 121 EVAL task in BP Server Monitor 121 Excel spreadsheet 68 96 114 Extensions on missing files 86 F F1 key for Help 66 Failed image entry 40 Failed queue list 39 Failed queues 82 File types 19 143 Full files 30 FULL JB 97 100 FULL VC PTR 97 100 Functional flow of VistA Imaging 3 Copy Error message 72 Generic Carbon Copy field 17 in Network Location Manager 43 queue 12 62 queue for photo IDs 55 window 48 Generic carbon See GCC Get Next Raid Group Failure message 72 GO DFN mismatches 89 GP amp GO AP Mismatch 89 GP has no images 88 GP Missing GO Ptr 89 GRP type of storage 65 H Hardware requirements 7 Hash subdirectory 43 44 45 46 47 48 94 Help getting 66 HTML files 68 96 IEN count tranversed in Purge 113 for IMPORT queue 81 for processing in Verifier 86 image record currently being processed 94 in NETWORK LOCATION file 65 in Process Queue 66 in record number in Network Location 51 in Scheduled Verify 12 in the NETWORK LOCATION file 92 93 integrity checks 88 marked by Offline Image utility 126 patient data integrity check 87 range to set in Verifier 91 record in Network Location 44 record number in Network Location 45 46 48 49 50 text file integrity check 90 verifying 87 verifying range 125 verifying range copied to Image sh
78. 702 101945 Queue ptr 21210517 De queue Holding FIVE sec for Station amp 508 3100702 113004 Queue ptr 21213583 De queue Holding FIVE sec for Station amp 508 3100702 124822 Queue ptr 21217991 De queue Holding FIVE sec for Station amp 1508 3100702 133505 Queue ptr 21220844 De queue Holding FIVE sec for Station 1508 82 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 4 6 3 4 Purge Queue by Type Entries Occasionally some queues build to a large number of entries because the queues are not assigned to a BP Server or a setting was made unintentionally For some queue types the entries are no longer needed or were erroneously placed on a queue and can be entirely deleted One way to display these queue entries is to use the Queue Manager Edit gt Queue Manager When the queue counts are high for any of the queues the GUI may take an extended period of time to display the entries while the Queue Processor appears to hang The Queue Management by Type window which displays the same information on the queue counts opens immediately no matter how many entries are in each queue In addition to deleting queue entries for a particular queue you can re queue all the entries in a particular queue If specific entries need to be re queued use the Queue Manager window You can select Active or Failed queue entries as follows e Failed Queues all of the queue types are selectable and the
79. 8 DCM DM000787 DCM DM000786 DCM DM000785 DCM DM000784 DCM DM000783 DCM DM000782 DCM DM000781 DCM DM000780 DCM DM000779 DCM DM000778 DCM DM000776 DCM DM000775 DCM DM000774 DCM DM000773 DCM DM000772 DCM Aggregate 6485 793 8 18 2009 3 Aggregate 6 ABS 792 8 18 2009 3 4 Aggregate 6ABS 791 8 18 2009 3 4 Aggregate 6 ABS 789 18 18 2009 3 2 Aggregate 5 788 8 18 2009 34 Aggregate 6 ABS 787 8 18 2009 3 4 Aggregate ABS 786 8 18 2009 3 Aggregate 6 485 785 8 18 2009 3 4 Aggregate 5 784 8 18 2009 3 Aggregate 6 ABS 783 8 18 2009 34 Aggregate 5 782 18 18 2008 3 2 Aggregate 5 781 8 18 2009 34 Aggregate 6 ABS 780 8 18 2009 3 4 Aggregate ABS 779 8 18 2009 3 4 Aggregate 6 485 778 8 18 2009 3 Aggregate 6 ABS 776 8 18 2003 3 2 Aggregate BABS 775 8 18 2009 3 Aggregate 6 ABS 774 18 18 2009 3 2 Aggregate 5 773 8 18 2009 34 Aggregate ABS 772 BABS DCM TXT amp ABS DCM TXT amp ABS DCM TXT BABS DCM TXT BABS DCM TXT amp ABS DCM TXT amp ABS DCM TXT BABS DCM TXT amp ABS DCM TXT amp ABS DCM TXT B ABS DCM TXT amp ABS DCM TXT amp ABS DCM TXT amp ABS DCM TXT BABS DCM TXT amp ABS DCM TXT amp ABS DCM TXT B ABS DCM TXT amp ABS DCM TXT amp ABS DCM TXT 2ABS TXT DCM 2ABS TXT DCM 2ABS TXT DCM 2ABS TXT DCM 2ABS TXT DCM 2ABS TXT DCM 2ABS TXT DCM 2ABS TXT DCM 2ABS TXT DCM 2ABS TXT DCM 2 ABS TXT DCM 2ABS TXT DCM 2ABS TXT DCM 2ABS TXT DCM 2ABS TXT DCM 2ABS TXT DCM 2
80. 800 0 98765N000827312 DM001800 DCM 0 0 D0 35 0PH 794 2 3010820 2245 1 26 OPTHOMOLS 40 NOTE 1 75 57 100 660 RP lt NOTE translation in effect J MAGPATIENT 988765 M 2340000 000486942 1 DP 111767536 CHIPEWA STREET SALT LAKE CITY 49 32404 9 32404 3227 381 3040000 660 52 LR SST MPI 6800000002 359491 860 1 13 VistA Global 148 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 SOP Instance UID field the text does not match the one VistA 0008 0008 Image Type CS 4 1 FAG 0008 0016 SOP Class UID UI 1 1 1 2 84 1 0008 0018 5 Instance UID UI K1I1 2 826 0 1 3680043 2 139 2 310 1 347259905281 20020423195426 7 0008 0020 Study Date DA 1 1 20020423 0008 0021 Series Date DAJ1 1 20020423 0008 0023 1 1120020423 Text File Global MAG 2005 1800 NOTE translation in effect MAG 2005 1800 0 MAGPATIENT 2468 000665698 CT LUMBAR SPINE W CONT DM O01500 TGA 2 2 56 3 1 007 CT 1 459 0 2 3020213 141133 LUMBAR SPINE WICONT 41 3020208 1321 74 73 VistA Global E Study Instance UID field in the text file does not match the one in VistA 0018 7052 Filter Thickness Minimum ps 1 1 0 0018 7054 Filter Thickness 05 1 1 0 0018 7060 Exposure Control Mode cs 1 S AUTOMATIC 0018 7062 Exposure Control Mode Description 0020 000D Stu
81. 9 09 45 30 0400 EDT 18 lines From lt xxx DETROIT MED VA GOV gt SITE DETROIT MED VA GOV DATE OCT 23 2009809 45 30 EDT Cannot determine place location division institution for image At GETPLACE 5 MAGBAPI 3 I PLACE S MAXREP 10 D Called From 1 1 0 SSGETPLACE O MAG 2006 1 B IEN January 2012 Background Processor User Manual Rev 10 71 VistA Imaging MAG 3 0 121 4 6 2 3 Auto RAID Group Purge This message is sent by the Queue Processor when the following conditions occur The Scheduled RAID Advance Group is scheduled and the Auto Purge is set e The next share in the RAID group reaches the Percent Server Reserve and a purge is automatically started Example Subj Auto RAID group purge 31180 10 27 098015 04 2 lines From VistA Imaging Auto RAID group purge basket Page 1 New SITE IMGDEMO1 MED VA GOV DATE Oct 27 2009 15 04 37 EST 4 6 2 4 Copy Error This message is sent during processing when GCC queues have connectivity problems Example Subj GCC Copy Error 31157 10 07 09 20 36 6 lines 1 New From VistA Imaging GCC Queue Error In IN basket Pag SITE IMGxxx MED VA GOV DATE Oct 07 2009 20 36 22 EST culty copying files to the network times with an error status of Export Share The next notif
82. ABS TXT DEM 2ABS TXT DCM 2 2 2 2 2 2 2 2 2 2ABS TXT DCM 2ABS TXT DCM 2 2ABS TXT DCM 2ABS TXT DCM 2 2ABS TXT DEM 2ABS TXT DCM 2 2ABS TXT DCM 2ABS TXT DCM 2 2ABS TXT DCM 2ABS TXT DCM 2 2ABS TXT DEM 2ABS TXT DCM 2 2ABS TXT DCM 2ABS TXT DCM 2 2ABS TXT DCM 2ABS TXT DCM 2 2ABS TXT DCM 2ABS TXT DCM 2 2ABS TXT DCM 2ABS TXT DCM 2 2 2 ABS TXT DCM 2ABS TXT DCM Scope ALL Check Image Text Don t Check Range ALL Description Image Shares IEN Network Location 2005 2 2005 2 Entry number in the NETWORK LOCATION file Name of the entry in the NETWORK LOCATION file Physical Reference Network path of this Network Location entry Scan Controls Scope Setting e All Scan all records the last scanned record e Range Scan records in specified range e Auto Automatically scan newly acquired files after Check Image Text Progress Setting Number of records processed e Check Compare specific fields in the text files on RAID with data contained in the associated IMAGE file 2005 records in VistA e Don t check Don t compare fields above Range Setting January 2012 Start Beginning in range to scan e Stop Ending IEN in range to scan Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 93 94 Description Summary S
83. AG 3 0 121 January 2012 Description Package_IEN PARENT GLOBAL ROOT field 17 in IMAGE file 2005 the number in the left column 3 9 MAIL MESSAGE 63 AUTOPSY MICROSCOPIC 63 02 ELECTRON MICROSCOPY 63 08 SURGICAL PATHOLOGY 63 09 CYTOLOGY 63 2 AUTOPSY GROSS 74 RADIOLOGY 130 SURGERY 691 ECHOCARDIOGRAM 691 1 CARDIAC CATHETERIZATION 691 5 ELECTROCARDIOGRAPHY 694 HEMATOLOGY 699 ENDOSCOPY 699 5 GENERIC MEDICINE 8925 TIU Image_Class Hierarchy in a study parent child Error_Level Severity level 1 highest 2 high Memo Integrity issues to resolve January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 103 5 7 2 Emails The following messages are generated or triggered by the Verifier 5 7 2 1 Imaging Integrity Check message This message is sent when the Verifier completes a scan The message identifies the time span involved and a summary of integrity errors Example Subj Imaging Integrity Check 431164 10 26 09822 32 6 lines From VistA Imaging DFN Summary basket Page 1 New SITE IMGxxxx MED VA GOV DATE Oct 26 2009022 32 51 EST 51 entries scanned Summary 2 occurrences of NO IMAGE PTR IN 1 type errors Database scan took 0 0 5 5 7 2 2 Imaging Site Verification Issue This message is sent when there is a network issue that is preventing the Verifier from accessing shares Ex
84. ASITESERVICE IEN The record number in VistA for this Network Location PHYSICAL REFERENCE URL name of the location of the WEB service OPERATIONAL STATUS Logical state of the service ONLINE or OFFLINE STORAGE TYPE URL 50 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 3 7 1 7 Diagrams Tab The Diagram Annotation tool is an optional Imaging component that is accessed from CPRS The Diagram Annotation tool is used to annotate online diagram templates and then save the results directly to a patient s electronic medical record To edit the properties of a network location right click the entry and select Properties on the pop up menu Note This popup menu can also be accessed from the keyboard by using Shift F10 RAD JUKEBOX Rowen GOC URLs NETWORK LOCATION EN PHYSICAL REFERENCE OPERATIONAL STATUS STORAGE IHMITTIZZEERTDZITTLCTINENENEM Cache Shore Name DIAGRAMS Sep Type Network Shave DUGRAM amp v Ok lt 7 Help rco MENS Field Description NETWORK LOCATION The name of this template location IEN The record number in VistA for this Network Location PHYSICAL REFERENCE The UNC Universal Naming Convention containing the server and share name for the template location O
85. Action Choose another IEN range Close the application and restart Check with the VistA system manager for the status of the Broker listener Assign the user this menu option Use the Queue Processor s Network Location Manager to check add the shares Enter a valid From and To range Create Edit the jukebox shares in the Network Location Manager on the Queue Processor Use the option BP Servers on the Queue Processor to register this server January 2012 Message Verifier client software is version nnn VistA Imaging Host software is version mmm Please update to compatible client and host software Shutting down Verifier VistA shares are not setup 8 5 2 Output HTML Messages Explanation The version of the KIDS file installed on VistA does not match the executable version on the workstation The image share s are offline or don t exist in the NETWORK LOCATION file 2005 2 Action Install the latest KIDS and client software Create Edit the shares in the Network Location Manager on the Queue Processor Message Explanation Action Aggregate JB Copy Error Could not copy from alternate jukebox to current jukebox Check permissions Abs to JB Abstract has been created and None copied to the jukebox Aggregate Function Enabled Software is enabled to copy files None from secondary jukebox if necessary BIG Aggregate Failed Could not copy BIG file from
86. BSTRACT queue 12 60 Access Verify codes 9 128 Active parameter 31 Active queue list 39 Active queue pointer 39 Active queues 82 Ad Hoc Enterprise Site Report 71 Ad Hoc Image Site Usage message 71 Alt JB Refs 93 Annotation diagrams 43 Annotation tool 51 Application Process Failure message 71 Applications of the BP Processor 1 Archive Appliance 127 128 ASSOCIATED INSTITUTION field 8 04 71 Associated Institutions 17 Auto option in BP Verifier 91 Auto Purge 31 72 AUTO PURGE queue 12 Auto Write Location Update 18 Auto RAID Group Purge message 72 AutoRouter 43 B Background Processor applications of 1 features 4 VistA Imaging in 2 What is 1 BackProc log file 69 Bad JB Refs 93 Bad VC Refs 93 Big Files 30 BIG JB 97 100 VC 98 100 BP Server Monitor configuring 122 daily monitoring 125 description 121 email message sent 76 monitoring the BP Purge 126 monitoring the BP Queue Processor 124 monitoring the BP Verifier 125 scheduling 122 BP Servers adding 10 assigning tasks 11 assigning tasks to 38 configuring 9 required for processing 57 server properties 13 BPError log file 70 Broker failure 128 C Capture Keys use 19 Check Image Text 91 Check text files 35 36 Clinical Association Report AP 88 89 136 Compression decompression 47 Configuring BP applications
87. C Broker software and OTG Disk Extender jukebox software can be found in the VistA Imaging Installation Guide The VistA Imaging System documentation suite includes e Release Notes e Installation Guides e Security Guide e Technical Manual e User Manuals This manual is also available at http vaww va gov imaging 1 1 Terms of Use Use of the Background Processor is subject to the following provisions D Caution Federal law restricts this device to use by or on the order of either a licensed practitioner or persons lawfully engaged in the manufacture or distribution of the product d No modifications may be made to the software workstation without the express written consent of the VistA Imaging National Project Manager 1 2 Intended Audience This software should be maintained by trained Imaging Coordinators who have IT experience and a thorough knowledge of the Imaging product 13 Conventions This document uses the following conventions Change bars in margins indicate content added or updated since the last revision e Controls options and button names are shown in bold Keyboard key names are shown in bold and in brackets lt gt Sample output is shown in monospace e When this document is used online hyperlinks are indicated by blue text e Useful or supplementary information is shown in a Tip January 2012 Background Processor User Manual Rev 10 lil VistA Imaging MAG 3 0 121 Required or import
88. CHADWOWOW 111217 HAD0000011438 DCM Purge Criteria 3 0 10 PM 4 3 2009 Description Date Time Date and Time of purge Event_Type Displays the final purge criteria for the file listed See Purge Criteria section Message Image file and access creation or modified date depending on the criteria January 2012 Background Processor User Manual Rev 10 117 VistA Imaging MAG 3 0 121 6 6 2 Emails The following e mail messages are generated or triggered by the Purge 6 6 2 1 Scheduled_Purge_Failure message This message is sent by the Monitor Background Processor Activity MAGQ BPMONITOR menu option to indicate that the Scheduled Purge did not run The BP Server may not have been assigned the PURGE task therefore there is a risk that the shares will run out of free space Run a manual purge if necessary until the problem is resolved Example of the message when the Purge is scheduled but fails to start Subj Scheduled_Purge_failure 31195 10 27 09 12 40 4 lines From VistA Imaging IN basket Page 1 New SITE IMGxxxxx MED VA GOV DATE Oct 27 2009 12 40 01 51 SALT LAKE CITY implementation of VistA Imaging has failed to start the sche dule Purge activity The task is currently assigned to BP Server ISW xxxxx LT Example of the message when the PURGE task is not assigned to a BP Server 118 Subj Scheduled Purge failure
89. D Group Advance scheduling Last RAID Advance Date when the last scheduled RAID Group Advance occurred Frequency in days Number of days added to the date of the last RAID Group Advance to determine the next time the RAID Group Advance will run If the Frequency parameter is set the next RAID Group Advance will be scheduled automatically Next Advance Date Date of the next scheduled RAID Group Advance Advance Time January 2012 Required Time of day of the next scheduled RAID Group Advance Background Processor User Manual Rev 10 37 VistA Imaging MAG 3 0 121 3 5 3 2 Parameter Guidelines for the Scheduled RAID Group Advance Sites can choose a configuration that suits them best as follows e Use the initial configuration where all the shares are in the same RAID Group The new images will be evenly distributed among all the shares e Nightly incremental tape backups as well as monthly quarterly tape backups must be done on a regular basis on all the shares e Distribute the shares among multiple RAID Groups Fill the shares in each group to the Server Size and then switch the current write group to the next New image files will be distributed over all the shares assigned to that group e Nightly incremental tape backups as well as monthly quarterly tape backups must be done only on that RAID Group e When it has reached capacity a final full backup should be done on all the shares and nightly incremental
90. Date Purge Time Field Checkbox Description Auto Purge Enables the Purge to run when the high water mark is reached on a RAID Group Last Purge BP Server BP Server on which the last purge was run Purge Factor Multiple of the Server Reserve When the free space falls below this value a purge is initiated on the next available online RAID Group The default value is 2 Express Purge Section Active Purge Rate Enables an Express Purge When the number of image entries that have been evaluated for purging based on the date criterion without deletion the purge process for that share will cease The default Purge Rate value is 100 000 Scheduled Purge Section Active Enable scheduled purges Last Purge Date Date when the last purge was run Frequency in days The number of days added to the Last Purge Date to determine the next Scheduled Purge Date This occurs at the end of a Scheduled Purge If this field is left blank the Scheduled Purge can be scheduled for a single event When the event takes place the Next Purge Date is cleared Next Purge Date Purge Time Next scheduled Purge date Time of day for the next scheduled Purge January 2012 Background Processor User Manual Rev 10 31 VistA Imaging MAG 3 0 121 Note Before an automatic purge is set up a manual purge should be run on share to make sure the Purge Parameter
91. Folders E vista amp Certed2009 n8 18 html 51 HTML Document 8 18 2009 3 47 PM A Broker amp certedz009 08 18 01 html 90KB HTML Document 8 18 2009 3 50 PM Imaging Certed Log OKB Text Document 8 18 2009 3 50 PM 4 BackProc DFNError2009_03_18 html 6KB HTML Document 8 18 2009 3 47 PM 4 E DFNError2009_08_18_01 html 17 HTML Document 8 18 2009 3 50 El log DFNError Log OKB Text Document 8 18 2009 3 50 PM A BackProc NoArchive2009_08_18 html 67 KB HTML Document 8 18 2009 3 47 PM 4 purge NoArchive2009_08_18_01 html 74KB HTML Document 8 18 2009 3 50 PM A e NoArchive Log OKB Text Document 8 18 2009 3 50 PM 4 5 2009 08 18 html 1 HTML Document 8 18 2009 3 42 PM 4 5can2009_08_16_01 html 1 170 KB HTML Document 8 18 2009 3 47 PM A amp Scanz009 08 18 02 html 14KB HTML Document 8 18 2009 3 47 PM scanz009_08_18_03 html 782 KB HTML Document 8 18 2009 3 50PM Scan Log 4KB Text Document 8 18 2009 3 50 PM ScanError2009 08 18 html 1KB HTML Document 8 18 2009 3 42 PM A amp ScanError2009 08 18 01 html 481KB HTML Document 8 18 20083 47PM amp ScanError2009 08 18 02 html 281KB HTML Document 8 18 2009 3 50 PM A ScanError Log OKB Text Document 8 18 2009 3 50 PM 4 If more than one log file is run on the same day the system adds a sequence number such as 01 following the date in the file name For mu
92. G 3 0 121 The Queue Manager window shows each of the queues that been assigned to a server It displays Failed and Active status categories under each task The Active branches show unprocessed entries for new images The Queue Processor executes each task in a priority order starting with JBTOHD as the highest When a queue entry for a particular task does not complete successfully it is placed on the Failed list for that task The error condition is listed below the Failed entry in the tree There can be different reasons for the failure for each task Each one is listed in the Queue Manager tree The Queue Manager displays the status counts Active Failed for each task as well as details about the entry In the Queue Manager the queues are subdivided into a tree structure The lowest node of the tree represents an individual queue file entry You can move the active queue pointer to entries anywhere in the queue list for a particular task The Queue Processor will process entries from this new location In addition you can re queue Failed tasks and delete tasks from both the Active and Failed queue lists 3 6 1 Queue Manager Operations The Edit Queue Manager menu on the Queue Processor menu bar opens the Queue Manager main window Eck yew Main Ste Parameters 1 Mai Messages Mal Groupe Purge Settings 88 Servers Queue Manage ABSTRACT Feed 2 DM has an ABS already re 2
93. ID D40 Ele Edit Help VistA Storage Stop Network Location Storage EN Space Disk Size Share Path RAID Group Background Processor Event Log 3 Click the Start button in the upper right hand corner If the Queue Processor is not properly configured you will get alert messages Review the steps in section 2 5 Configuring BP Servers 4 After one or two minutes click the Stop button and view the populated fields If no queues have entries only the storage statistics are displayed in the VistA Storage section of the window 64 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 The following example shows sample output of processed activity The queues being processed are displayed under the Start button Eile Edit Yiew Help WORM OTG 6 MAG 90 MAG 89 Network Location Storage Type IEN Free Space Disk Size Share Path RAID Group 42240 42944 WHAISWWHITEVM ABSTRACT 0 JUKEBOX 6211 5332 5362 WHAISWAWHITEVM RG QRT1 JBTOHD 0 in Site Name Queue Processor 10 06 00 AM username JOB ID PID 040 5 gt VistA Storage 5332 5362 WHAISWWHITEVM RG QRT1 0 MVHAICUAMHITE 10 8 2009 10 03 02 AM JUKEBOX 139 Background Processor stop button depressed There are no network location references for this image DM000735 TGA 10 8 2009 10 03 06 AM JUKEBOX 143 There
94. IG files found Total Text Total number of TXT files found Purge File Count Total Share Files Total number of files deleted on all the shares processed Deleted Purged Abstracts Total number of ABS files deleted on all the shares Purged Full Total number of Full files deleted on all the shares Purged Big Total number of BIG files deleted on all the shares Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 January 2012 Background Processor User Manual Rev 10 121 VistA Imaging MAG 3 0 121 Chapter 7 System Monitoring e Description of the BP Server Monitor Utility e Configuring the BP Server Monitor e Scheduling the BP Server Monitor e Monitoring the BP Queue Processor e Monitoring the BP Verifier e Monitoring the BP Purge Important The Imaging Coordinator s primary tasks involve monitoring the BP by reviewing the log files on a daily basis 7 1 Description of the BP Server Monitor Utility The BP Server Monitor is a utility that sites can configure to monitor the activity of BP Server s in the VistA Imaging system The utility sends an e mail when one or more BP Servers are not operating properly and it monitors the assigned tasks of BP Server s to determine if e A task is lagging behind e The task has too many failed queues e scheduled task has not executed The utility enables the Imaging Coordinator to evaluate the BP Server s to determine whether a network traffic pro
95. IMAGE file 2005 and or IMAGE AUDIT file 2005 1 where the BIG image is located Image share that is the current write location This will change automatically if the AUTO WRITE LOCATION UPDATE option is selected The check for space is done after 100 Writes to the share or after 20 minutes since the last check whichever comes first JB ALT 1 2 3242 for the archive jukebox share in the NETWORK LOCATION 2005 2 file If a site has 2 or more archive devices jukeboxes then the second third etc are the alternate archive devices jukeboxes January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 101 5 7 1 4 Note Call the National Help Desk for assistance in fixing any of these issues DFNError Log File The DFNError log file displays integrity issues with patient data The Memo column messages shown below are described in checks on Patient Integrity Address C Program Files ist4 Imaging BackProc log verifier DFNError2009_08_18 html gt Go Image Patient Name 1 560 PATIENT ONEFIV 154 662 PATIENT FIVESE 575 663 PATIENT FIVESE 575 DFN 1 SSN 1 Patient Name 2 DFN 2 SSN 2 Package Package IEN Image Class Error level Memo CONFLICTING 000000154 PATIENT FIVESE 575 000000575 2 NG 1 AP amp IMAGE DFNS DFN Mismatches in AP Image 000000575 PATIENT ONEFIV 154 000000154 3
96. JUKEBOX request are described below l When an image is processed by the DICOM Gateway or Clinical Capture workstation the image file is copied to a RAID share The VistA record for that image is updated with the RAID share location The Clinical Workstation application or DICOM image gateway then requests that an image be saved to the jukebox by creating an entry in the JUKEBOX queue file on VistA The queue entry identifies the file path the origination of the file and other pertinent data that the Queue Processor will need to successfully complete the processing When the JUKEBOX queue entry is processed the image file is copied from the RAID share to the archive device jukebox and the queue entry is deleted from the queue file The queue count for the JUKEBOX queue is decremented to reflect the number of remaining queue entries to be processed January 2012 Background Processor User Manual Rev 10 63 VistA Imaging MAG 3 0 121 4 5 Starting Running the Application 4 5 1 Starting the Application and Analyzing the Activity 1 From the Windows Start gt Programs menu select VistA Imaging Programs gt Background Processor gt Queue Processor 2 Log into the application using a valid VistA access and verify code Note The secondary menu option MAG WINDOWS is required for access to the Queue Processor The Queue Processor application window opens Site Queue Processor 9 01 30 AM username 308 ID P
97. January 2012 Background Processor User Manual Rev 10 13 VistA Imaging MAG 3 0 121 Processor must have Read and Write access to it Use the computer name share name format and do not use a letter drive 4 Click OK to save the information and close the window 14 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 Chapter 3 Configuring the Application e Configuring the Imaging Site Parameters e Configuring Mail Messages e Configuring Mail Groups e Configuring the Purge Verifier and RAID Group Advance Settings e Configuring the Queue Manager e Configuring the Network Location Manager 3 1 Introduction All the parameters for running the BP applications Queue Processor Verifier Purge are managed through the Queue Processor GUI There are multiple parameter windows that you can use to change settings for each BP application The parameter windows are accessed through the Edit menu on the BP Queue Processor application menu bar Edit Imaging Site Parameters Mail Messages Mail Groups Purge Verifier RG Settings BP Servers Queue Manager Network Location Manager 3 1 1 Overall Guidelines e The three BP applications Queue Processor Verifier and Purge are installed with a default configuration However you will need to configure settings for each one depending on how when where you want these applications to run When the BP is first installed review the parameters to insure the produ
98. LLATION MAG SERVER MAGDERROR MAG GB Ad Hoc Image Site Us MAG GB Application process GB Auto PAID group purg MAG GB GCC Copy Error MAG GB Get Next RAID Group 2 Image Cache Critically Low Mail Users Image File Size Variance H Imaging Integrity Check a Imaging Site Verification Issue Monthly Image Site Usage Photo D Action Scheduled Verifier failure Site_report_task_was_restarted VI BP Queue VI BP Queue Processor failure lt Click here to view Mail users Security Keys Holders MAG CAPTURE MAG DELETE MAG EDIT MAG NOTE EFILE MAG PAT PHOTO ONLY PREFFTCH 3 3 1 1 Displaying Mail Users The list of the hospital users in the Mail Users section is not immediately displayed until you click in the area shown in the previous screen image The list may take a few minutes to appear depending on the number of end users defined in the site s VistA database The following is an example of a displayed list of mail users MAGPROVIDERONE THREE ONE THREE O HREEFIVE IREEFIVE INE THREEFIVENINE NINE MAGPROVIDERONFTHREF ONE ONE THREE ONE 22 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 3 3 1 2 Adding Names To select a name and associate it with a particular Mail
99. MAG GB Imaging Integrity Ch MAG GB Imaging Site Verific MAG Monthly Image Site U MAG GB Photo D Action MAG Scheduled Purge fail 2 MAG GB Scheduled PAID Group MAG Scheduled Verifier f MAG GB Site report task was MAG GB VI BP Eval Queue MAG GB VI BP Queue Processo MAG GB Verifier Scan Error 2 MAG GO Ad Image Site Us MAG GO Application process MAG GO Auto RAID group MAG GO GCC Copy Error MAG GO Get Next_RAID_Group_ O INSTALLATION GO Image Cache Critical GIMAGING DEVELOPMENT TEAM FORUM VA GOV Rem Men Users Click here to view Mail users Mail Groups MAG SERVER MAGDERROR MAG GB Ad Hoc Image Site Us MAG GB Application process MAG Auto RAID group MAG GCC Copy Error MAG Get Next Group MAG GB INSTALLATION MAG GB Image Cache Critical MAG GB Image File Size Vari MAG Imaging Integrity Ch Field or Checkbox Description Mail Groups List of the existing Imaging Mail Groups defined in the VistA database Users box Name Complete list of users with mailboxes defined in the VistA database 24 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 3 4 1 1 Displaying Mail Users The list of t
100. Manual Rev 10 91 VistA Imaging MAG 3 0 121 5 6 Starting Running the Verifier The Verifier can be started as an independent application or can be scheduled to run in the background at prescribed time intervals See Section 3 5 The following steps describe how to run the Verifier in the foreground 1 From the Windows Start gt Programs menu select VistA Imaging Programs gt Background Processor gt Verifier 2 Log into the application using a valid VistA access and verify code The secondary menu option MAG WINDOWS is required for access to the Verifier The BP Verifier window opens BP Verifier 3 38 08PM WSID JOB ID JukeBox Shares Check Image Text Check Don t Check 3 In the Scope box select one of the following options Range Type a start and stop IEN The Verifier will process this range of IENS inclusively If the Start is greater than Stop IEN the Verifier will scan the image records backwards e All Every IEN record in VistA will be processed e Auto The Verifier will process IENs from the highest backwards to IEN that was previously processed 4 Inthe Check Image Text box select one of the following options Check Compare specific fields in the text files on RAID with data contained in the associated IMAGE file 2005 records in VistA Processing time will increase moderately Don t Check Do not do any com
101. ONETWOONEFOUR JUL 20 20098122018 PROCESSED January 2012 Background Processor User Manual Rev 10 39 VistA Imaging MAG 3 0 121 3 6 2 Purging a Queue Circumstances may arise when single or multiple queue entries need to be deleted One example involves JBTOHD tasks When JBTOHD entries have not been processed in a period of time a day or more the usefulness of retrieving these images diminishes There may be hundreds of these queue entries for a study You can select multiple entries using the Queue Manager and delete them 1 Select the entries to be deleted 2 Right click in the selected area 3 Inthe popup menu displayed select Purge Queue Note This popup menu can also be accessed from the keyboard by using Shift F10 T 20108055654 FROCESSEC 23 ABSTRACT SJBTOHD 5 DUND USERI MAR 11 2010 95 5654 NOT PROCESSED 8823 FULL 10J8TOHD OUNDJUSE3 11 2010 0556 54 NOT PROCESSED 8823 BIG e 11J8TOHD OUNDJUSE3 11 20106055654 NOT PROCESSED 8825 ABSTRACT 4 Acknowledge the verification popup The entries will be deleted and the Active Failed queue count will be changed to reflect the change Do you wish to Purge all selected 4 Active queues mJ J E No Cancel 3 6 5 Re Queuing a Failed Image File The Queue Processor will attempt to process an entry three times to get a successful result After the third attempt the entry is placed
102. P NAME SERVER MEMBER Mail Group MAG INSTALLATION Field or Checkbox Description Description Describes the purpose of the mail group Editable Organizer The organizer is the person who set up created the mail group January 2012 Background Processor User Manual Rev 10 27 VistA Imaging MAG 3 0 121 Field or Checkbox Description Type Public Can receive mail from anyone Private Can only receive mail from a predefined Public group Display only Restrictions Unrestricted Used when creating a Public mail account Anyone can mail to this account Organizer Only An organizer can add new members to a Private mail group Display only Member Lists the users in the mail group Member group The parent group name for this mail group Remote Member E mail address of a VA user who is external to the site but part of the domain 3 5 Configuring the Purge Verifier and RAID Group Advance Settings The Purge Verifier RAID Groups window is used for setting up the Scheduled Verifier Scheduled Purge and RAID Group Advance activities In addition the parameters for the Purge activity are set up through this window Selecting the Edit gt Purge gt Verifier gt RG Settings menu on the Queue Processor menu bar opens the Purge Verifier RAID Groups window i SALT LAKE CITY BP Purge Verifier RAID Group Advance Settings
103. PERATIONAL STATUS Logical state of the service or OFFLINE STORAGE TYPE DIAGRAM January 2012 Background Processor User Manual Rev 10 51 VistA Imaging MAG 3 0 121 3 7 2 Adding New Location to Network Location Manager Note The following procedure applies to all the tabs in the Network Location Manager window 1 From the Queue Processor menu bar select Edit gt Network Location Manager to open the following window The RAID tab is automatically selected To add a new network location click the New button at the bottom The Network Location Properties window will be displayed site Network Location Properties E ni xj r Cache IDs 7 ShaeName o Network Share C JUKEBOX Im C EKG C GCC C DIAGRAM C URL C ROUTER Cancel Appl 3 the Share Name At the Network Share field either type the path to the location where images are to be stored or click the browse button and specify the path Select the appropriate option at the Storage Type field Click Apply Additional fields relevant to the storage type are displayed The example below is for Storage Type RAID only Note The STORAGE field is preselected depending on the Network Location tab selected If the EKG tab is selected then the STORAGE TYPE will be set to EKG and so forth However the preselected value can be modified
104. PROCESSED ABSTFACT 15 BACKGROUND USER 11 20103055654 PROCESSED FULL 16J8TOHD BACKGROUND USER MAR 11 21082065654 PROCESSED BIG 17 J8TOHD BACKGROUND USER 11 20102055854 NOT PROCESSED ABSTFACT 18J8T0HD ji BACKGROUND USERI MAR 11 20102055554 NOT PROCESSED FULL 19J8T0HD BACKGROUND USER 11 21020656554 NOT PROCESSED BIG 20J8TOHD i BACKGROUND USER 11 20102055554 NOT PROCESSED ABSTFACT 21 J8TOHD BACKGROUND USER 11 20108055654 PROCESSED FULL 22J8T0HD BACKGROUND USERI MAR 11 20102055654 PROCESSED BIG 3 6 5 Accessing Import Queue Properties You can access the failed Import Queue properties by right clicking a failed IMPORT queue node and selecting Import Queue Properties Note This popup menu can also be accessed from the keyboard by using Shift F10 January 2012 Background Processor User Manual Rev 10 41 VistA Imaging MAG 3 0 121 IMPORT Foiled 3 IMPORT Dequeue Failed on Track 0 IMPORT in progress 0 NOT_PROCESSED 0 Procedure end Imaging patents 2 19366194IMPORT ste 908 20 2010 10 42 08 Procedure end imaging patients dont match 5 Vist Entry deleted 1 Burge Queue 204740652 IMPORT Sie gt Aciive 0 Import Queue Properties 5 JBTOHO 0420109153144 VistA Image Entry deleted 2 When you right click the Failed queue item and select Import Queue Properties the same Import Queue Properties wind
105. T o VistA Imaging System Background Processor User Manual January 2012 Revision 10 MAG 3 0 121 Department of Veterans Affairs System Design and Development VistA Imaging Background Processor User Manual VistA Imaging MAG 3 0 121 January 2012 Property of the US Government This is a controlled document No changes to this document may be made without the express written consent of the VistA Office of Enterprise Development While every effort has been made to assure the accuracy of the information provided this document may include technical inaccuracies and or typographical errors Changes are periodically made to the information herein and incorporated into new editions of this document Product names mentioned in this document may be trademarks or registered trademarks of their respective companies and are hereby acknowledged VistA Imaging Office of Enterprise Development Department of Veterans Affairs Internet http www va gov imaging VA intranet http www va gov vdl Revision Table Date Patch Rev Description May 2002 Patch 7 1 Updated section 3 1 6 4 Operational Procedures Apr 2004 Patch 3 2 Updated section 3 1 8 10 and 5 5 7 6 to reflect transition to long file names May 2004 Patch 13 3 Expanded and updated Verifier content Moved Verifier content from Chapter 4 to end of manual Appendix B absorbed into Chapters 4 Purge and 7 Verifier
106. TML messages 134 Purge 138 Verifier 133 U UID field 90 UNC 46 48 49 51 65 URLs 43 in Network Location Manager 43 storage type 50 WEB service location 50 window 50 User Preference default 19 Username Windows 20 47 V Variance 73 VC Abstract 94 SOP 90 VC Big 94 SOP Instance 90 vc Full 94 SSN_1 101 Verifier SSN 2 101 description 85 E integrity checks 88 162 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 integrity samples 147 maintenance operations 87 manual 35 missing files 86 processing 86 reasons for running 87 scheduled guidelines for setting 35 scheduling 36 setting up 85 settings 34 starting 91 tasking 85 troubleshooting 133 What is 1 VI BP Eval Queue message 76 VI BP Queue Processor Failure message 77 VistA Access 20 VistA Imaging functional flow 3 VistA Verify 20 VistARad Grouping 18 WwW Watermarking Failed message 78 Watermarking Successful messsage 77 WEB service 50 Windows BP Verifier 91 Diagrams 51 EKG 49 Event 08 69 48 VistA Storage 78 Imaging Site Parameters 16 IMPORT Queue Status 79 JBTOHD Report 79 Jukebox 45 Groups 24 Mail Message Manager 22 Network Location Manager 42 Purge Verifier RAID Groups 28 Queue Management by Type 82 Queue Manager 39 Queue Processor application 64 RAID
107. Tools Help av Ob gt x 24 J Search 2 Favorites 47 2 Address C Program Files ista Imaging BackProc log BackProc BPError2010_03_30_0001 html gt Go Links Date Time Event Queue Ref Message Path 3 80 2010 11 49 01 GCC connection 3 30 2040 11 49 01 GCC connection NetConEror 3 30 2010 11 49 01 AM GCC connection NetconEmor 3 30 2010 11 49 01 AM GCC connection NetConEmor 3 30 2010 11 49 02 GCC connection NetConError 3 30 2010 11 49 02 GCC connection NetConEmor 3 30 2040 11 49 02 GCC connection NetConError 3 30 2010 11 49 02 GCC connection NetConEnor 3 30 2010 11 49 03 AM GCC connection NetConEtror 3 30 2010 11 49 03 AM GCC connection NetConEtror 3 30 2010 11 49 03 AM GCC connection NetConEror 3 30 2010 11 48 03 GCC connection NetConEror 3 30 2040 11 49 04 GCC connection NetConEror 3 30 2010 11 48 04 GCC connection NetconEmor 3 30 2010 11 49 04 AM GCC connection NetConEror 3 30 2010 11 49 04 AM GCC connection 3 30 2010 11 49 05 connection NetConError 3 30 2010 11 49 05 GCC connection NetConError 3 30 2010 11 48 05 GCC connection NetConEror 3 30 2040 11 49 05 AM GCC connection NetConEror Name Description Date Time Actual time when the IMAGE file 2005 was processed Event_Queue_Ref Error category Message Path Description of error condition 4 6 2 Email Messages The following
108. Verifier stops when it has processed all the IENs in the range specified Click Stop to terminate processing at any time When the Verifier run is complete you can enter a new set of Start Stop IENs in the SCOPE and start a new run Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 5 7 Reports Two types of reports are produced e Log files e Emails 5 7 1 Log Files New log files are created as HTML files each day and each time the Verifier is run HTML files are viewable printable and searchable By default they reside in the C Program Files VistA Imaging BackProc log Verifier directory You can access these files by e File gt Open Log on the BP Verifier menu bar e Internet browser These log files can be imported into an Excel spreadsheet Important These files should be kept for historical reasons and added to the tape backup storage process to safeguard the files See Appendix Backups in the VistA Imaging System Installation Guide Log File Format Verifier log files are archived as HTML files and have the year month day and sequence number imbedded in the file name as shown in the right pane of the window fli C Program Files VistANImaging BackProc log verifier Elle Edit Favorites Tools Help ay Q Back 17 2 Search Folders X 0 ES Address jo C Program Files istA Imaging BackProc log verifier Go
109. ack from the current date that files should be retained Photo IDs Source Source Patient photo images from the Clinical Capture workstations File extension JPG Range 0 99 999 number of days back from the current date that files should be retained Enter the number of days that each file type should remain on the shares based on the 3 file date purge criteria described in section 3 5 Purge Settings Note The FULL and BIG files are typically larger file sizes and consume more free space on the shares than the abstracts and photo IDs As aresult of their size set the retention days to fewer days to free more space 3 Because the abstracts and photo IDs are smaller files set the retention days for purging these two types of files to a higher value than the values for the FULL BIG file retention days 30 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 4 Because the abstract files viewed as thumbnails the Clinical Display workstation set the retention days to retain a minimum of 5 years 1 825 days on the shares regardless of the capacity of the RAID to make viewing on the Clinical Display workstations more efficient 3 5 1 3 Configuring Scheduled Express Purge Settings Auto Purge Purge BP Server Purge Factor 2 Express Purge Active Purge Rate fi 00000 Scheduled Purge Active Last Purge Date Frequency days Next Purge
110. ample Subj Imaging Site Verification Issue 853534 14 Dec 2009 08 50 04 0600 CST 8 lines From lt USER BGP CENTRAL ALABAMA MED VA GOV gt VERIFIER basket Page 1 New SITE CENTRAL ALABAMA MED VA GOV DATE DEC 14 2009008 50 04 CST 12 14 2009 8 50 04 AM The Jukebox share VHACAVIMMJB1 IMAGEJB1 S is not available All VistA Imaging Jukebox servers should be fully operational when operating the BP Verifier 31271 CB031271 TGA 7 ABS TXT BIG TGA 7 27 when operating the BP Verifier 104 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 5 7 2 3 Verifier_Scan_Error_Log message This message is sent by the BP Verifier at completion of the scan The report identifies the image entries in question Example Subj Verifier Scan Error 104 31165 10 26 09 22 32 165 lines From VistA Imaging Scan Errors basket Page 1 New SITE IMGxxx MED VA GOV DATE Oct 26 2009022 32 51 EST 0 26 2009 10 32 43 PM No Full VC Files 21158 QRT00000019369 ASC 2 74 0 26 2009 10 32 43 PM No Jukebox Full Files 21158 QRT00000019369 ASC 4 0 26 2009 10 32 43 PM Not Certed 21158 QRT00000019369 ASC 74 0 26 2009 10 32 43 PM No Full VC Files 21157 QRT00000019368 BMP 2 2 74 0 26 2009 10 32 43 PM No ABS file VC Ptr Cleared 21157 QRT00000019368 BMP T 4 January 2012 Background Processor User Manual Rev 10 105 VistA Imaging MAG 3 0 121 Chapter 6 Purge
111. ant information is shown with the word Note or Important e Critical information is indicated by D 14 Related Information The VistA Imaging System documentation suite includes e Release Notes e Installation Guides e Security Guide e Technical Manual Note Additional information about the various VistA Imaging components such as servers workstations Remote Procedure Call RPC Broker software and OTG Disk Extender Jukebox software can be found in the VistA Imaging Installation Guide 15 Imaging Support If you encounter any problems using VistA Imaging Background Processor contact your local Imaging Coordinator or support staff If the problem cannot be resolved locally use Remedy to place a service request or contact CPS Clinical Product Support at 1 888 596 4357 iv Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 Table of Contents iii Too iii T2 Intended Audience iii 1 3 8 s er TETN EAEN iii 154 Related Information sirere eiia e aa ioeie eae iv ES VistA Inmagme 5 aaa EE ceu iv Chapter I QM I SEINE EORR 1 1 1 Whatis the Background 25200 1 1 1 1 Background Processor Applications
112. ares 125 IMAGE AUDIT file file integrity 88 IMAGE AUDIT file 2005 1 duplicate image entries 93 Full image 94 No Archive log file 98 Image Cache Critically Low message 73 Image entry is structurally abnormal 89 IMAGE file 2005 file integrity checking 88 G Full image 94 patient integrity checking 88 89 GCC running Verifier 87 January 2012 Background Processor User Manual Rev 10 159 VistA Imaging MAG 3 0 121 validating network file references 154 Image File Size Variance message 73 Image_Class 102 Image IEN 101 IMAGE 99 IMAGING SITE PARAMETERS file 2006 1 9 71 Imaging Site Usage report 76 IMPORT queue 12 61 79 Import queue properties 41 Import Queue Security 17 IMPORT Queue Status report 79 Installation See the Background Processor Patch Description INSTALLATION message 74 Integrity checks 85 image file 88 patient 88 text file 90 Internal Entry Number See IEN Invalid Image Ptr to 89 J JB Big 94 JB Full 94 JB Path 1 95 JB Path 2 95 JB ALT 1 98 JBTOHD queue 12 59 JUKEBOX in Network Location Manager 43 queue 12 61 Jukebox Write Location 18 L log directory default 13 Log files BackProc 69 BPError 70 DFNError 101 NoArchive 98 Purge html 115 PurgeError html 116 Scan Log File 97 ScanError 99 specifying location and size on a BP Server 13 M MAG ENTERPRISE 71 MAG SERVER
113. be used for first time users of the Imaging system January 2012 Background Processor User Manual Rev 10 19 VistA Imaging MAG 3 0 121 3 2 1 4 Service Accounts Settings These credentials are shared between the DICOM Gateway Image cluster Jukebox Server and Background Processor Service Accounts Access Vist Verify Field or Checkbox Windows Username domain name usemame Description Windows Username Domain account used to access the Imaging shares on the RAID and archive jukebox share Both the RAID and archive jukebox shares must have READ WRITE permission to this account Windows Password Domain password used to access the Imaging shares on the RAID and archive jukebox share VistA Access Encrypted access code for the Imaging Service Account in VistA This account will be used to automatically re log into the application when there is a loss of connectivity between the BP product and the Broker VistA Note The Imaging Service Account must have the MAG SYSTEM security key and secondary menu option MAG WINDOWS VistA Verify Encrypted verify code for the Imaging Service Account in VistA This account will be used to automatically re log into the application when there is a loss of connectivity between the BP product and the Broker VistA 20 Background Processor User Manual Rev 10 January 2
114. blem exists and to maintain the tasks effectively 7 1 1 Evaluating EVAL Queues The BP Server Monitor does not evaluate unassigned tasks with the exception of the EVAL task The EVAL queues are generated by DICOM Gateways where the Routing parameters have been set Occasionally sites mistakenly set the Routing parameters and thus create EVAL queues inadvertently The BP Server Monitor utility reports on unprocessed EVAL queues when they reach a specified quantity A site having a large number of EVAL queues may slow the BP Server client software when displaying the Queue Manager window 7 1 2 Reporting Using Mail Messages All reporting by the BP Server Monitor uses the following Mail Messages subject texts VI BP Queue Processor failure Scheduled Purge failure Scheduled Verifier failure VI BP EVAL Queue January 2012 Background Processor User Manual Rev 10 122 VistA Imaging MAG 3 0 121 Descriptions of these messages in the Mail Messages section of chapters Queue Processor Verifier and Purge Recommendation These Mail Messages should be configured to include the appropriate personnel responsible for resolving a problem and to set up the message interval to control the number of messages sent For details see section 3 3 Configuring Mail Messages 7 2 Configuring MessagesConfiguring the BP Server Monitor The BP Server Monitor is a menu item in VistA Monitor Background Processor Activity MAGQ BPMONITOR Th
115. can restore these images to the RAID when requested by the display workstations The Background Processor s Verifier application maintains the integrity of image records including location pointers stored in the VistA database Flow VistA Images Queues Network Location Site Parameters Clinical Display VistaRad CPI y Clinical MED Consent Capture Broker Connect RPC 4 Remote Backround Processor Queue Processor Verifier 2 Legend Queue Processor Image migration path January 2012 Background Processor User Manual Rev 10 3 VistA Imaging MAG 3 0 121 1 4 Features of the Background Processor The Background Processor provides the following features 1 5 Manages image storage on various shared network devices Migrates image files between magnetic VistA Imaging shares and jukebox storage units Maintains adequate free storage space on VistA Imaging shares Copies image files to the VistA Imaging shares whenever they are requested by image display workstations Validates VistA Imaging network file references Verifies the integrity of the location of image files on Imaging shares recorded in the VistA database Configures local VistA Imaging site parameters Manages error recovery Logs activities and errors Imports images into VistA Imaging Exports images from VistA Imaging T
116. cannot be changed The functions of each task are 1 2 3 4 5 6 7 8 9 JBTOHD populates the VistA Imaging shares with images that have been deleted from the RAID shares through the Purge function PREFET populates the VistA Imaging shares with images that were requested based on VistA Imaging Display workstation configuration parameters ABSTRACT creates ABS derivative thumbnail files from FULL BIG files when the file type is missing on the RAID shares and archive jukebox IMPORT provides a means for external applications to archive images in the VistA Imaging environment JUKEBOX copies images to the long term archival storage device DELETE removes images from the VistA Imaging shares GCC exports images to a share that is external to the local VistA Imaging network PURGE This assignment includes both the auto purge and the scheduled purge tasks Refer to the purge section of this document for more details SCHEDULED VERIFY automatically runs the Verifier at the assigned time to check the integrity of the Image records in VistA with the file locations on RAID and archived storage Only the most recent unchecked IENs are verified 2 Click Apply to save the changes or OK to save the changes and exit 12 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 2 5 4 Removing Server from the VistA Imaging System 1 From the Queue Processor menu bar select
117. cquired images are currently being written Server Reserve The purpose of the reserve is to provide a significant amount of reserved primary storage to allow time for corrective action to create more space on the shares Enter an integer between 2 and 50 The system defaults to 5 if the integer is outside the normal range When the used space on a share exceeds the specified percentage then actions are taken within the BP mail message sent auto purging initiates if scheduled etc In addition the AutoWrite Location Update will be disabled and images will be written to that share until the free space is exhausted Auto Write Location Update At the interval of every 20 minutes or 100 images written to a share the Queue Processor will determine which share within a group has the most space and will use that share as the current write location for newly acquired images To manually select a RAID Write Location uncheck the Auto Write Location Update box Images will be written to the selected RAID share until it is filled or manually changed to another share Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 Field or Checkbox Description Multiple Namespace List of all the legacy namespaces that have been used at a site and are reflected in the filenames on the RAID and jukebox shares Note Right clicking this field displays an Add Delete popup menu that can
118. cription Kernel Mail Groups Alert informational message names VistA Imaging Mail Complete list of the Imaging mail groups defined in the VistA Groups database Users in the selected Mail Group will be sent the alert informational message Mail Users Complete list of users with mailboxes defined in the VistA database January 2012 Background Processor User Manual Rev 10 23 VistA Imaging MAG 3 0 121 Field Description Security Key Holders Complete list of the Imaging security keys in the VistA database Users that have the selected key will be sent the alert informational message 3 4 Configuring Mail Groups Users can be added to existing mail groups using the Mail Groups window These Mail Groups can be used to send alerts and informational messages to users through the Mail Message Manager window 3 41 Groups Window The Mail Groups window can be opened using the Edit gt Mail Groups menu on the Queue Processor menu bar site Mail Group Manager Imaging Site Parameters Mail Messages Groups Purge Verifier RG Settings BP Servers Queue Manager P r Mail Groups 5 4 MAG SERVER IMAGPROVIDERONETHREEFIVE ONETHREEFIVE Mem MAGDERROR MAG Ad Hoc Image Site Us MAG Application process MAG Auto RAID group purg MAG GCC Copy Error MAG Get Next RAID Group MAG INSTALLATION MAG GB Image Cache Critical 2 MAG GB Image File Size Vari 2
119. cts are set up according to your site s needs e ABP Server will need to be defined for each Windows server that will be running a task and or the Purge and or Verifier e specific task JUKEBOX JBTOHD IMPORT etc on the Queue Processor be run only on one server e A task must be assigned to a BP Server before that task will run when the Queue Processor starts e Some parameter windows have Apply buttons Be sure to click the Apply button to commit changes to the database Cancel resets any changed parameters The windows that do not have Apply buttons are committed when the change is made The OK button also commits the changes and closes the main parameter window January 2012 Background Processor User Manual Rev 10 15 VistA Imaging MAG 3 0 121 32 Configuring the Imaging Site Parameters The parameters on the Imaging Site Parameters window control activities within the Queue Processor as well as the DICOM Gateways Clinical Capture Clinical Display and VistARad The site parameters can be configured for these functionalities e Access to the image shares e Service account login information e Routing share configuration e Display and capture workstations e Gateways e Jukebox configuration e RAID Groups configuration 3 2 1 Imaging Site Parameters Window The Edit Imaging Site Parameters menu on the Queue Processor menu bar opens the Imaging Site Parameters window used to modify entries
120. d there is no retry Note You will be required to investigate and determine the reason for the failure and re queue the item once the problem is resolved 58 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 When all the tasks are assigned to one server the queues processed in the following order of priority e JBTOHD jukebox to hard drive restores images to the RAID shares from the archive device based on requests for viewing these images on display workstations or creating missing abstract files Note images can only be viewed from the RAID shares JBTOHD Queue Clinical Display Workstations VistaRad and or the Abstract queue add a request to the JBTOHD queue to copy image files from the Jukebox to VistA Imaging Shares for the Clinical Display Workstations or VistARad to access VistA Display Workstations gt VistA Imaging Shares RAID January 2012 Background Processor User Manual Rev 10 59 VistA Imaging MAG 3 0 121 PREFET pre fetch populates the RAID shares with images that were requested display workstations by users with the MAG PREFETCH security key PREFET Queue Clinical Display Workstations and VistARad add a request to the PREFET queue to copy image files from the Jukebox to VistA Imaging shares for VistA Display Workstations and VistARad to access Note Only for users who have the MAG PREFETCH security key VistA Display Workstatio
121. d Purge Active Checked PServer Reserve not used for this option Purge Factor not used for this option Frequency in days select interval in days Next Purge Date starting date Purge Time time of day the Purge will run 6 Click OK to close the window When a Scheduled Purge starts the time is recorded in the VistA database in the field Last Purge Date The Frequency is added to this date to determine when the Purge will start next All online RAID shares will be purged when this scheduled application runs Important The Queue Processor must be in the running state on the server where the Purge is scheduled in order for it to run i e the Start button on the Queue Processor GUI must be clicked 3 5 1 6 Running the Auto Purge There are two configurations where the Auto Purge is used e In the first configuration all the RAID shares are in the same RAID Group Inthe second configuration the shares are distributed into two or more RAID Groups The setup is the same for both groups except that the Purge Factor must be set for the second configuration January 2012 Background Processor User Manual Rev 10 33 VistA Imaging MAG 3 0 121 The application that runs for the Auto Purge is the same as the manual purge Reference the Manual Purge above for specific information about the GUI and log files Important If the PC that has Scheduled or Auto events is not a server class the task will not Start Note Th
122. d is not in the Import Queue Data Check the IMAGE file 2005 to see if the data is corrupt O Watermark failure error message The process of burning the Rescinded watermark onto the image file failed The AccuSoft ToolKit could not create the watermarked image Check if the rescinded bitmap exists in the image directory C Program Files vista Imaging Bmp MagRe scinded bmp You may need to reinstall MAG 3 0 121 to correct AccuSoft ImageGear problems An Abstract for this file is on the Jukebox a JBTOHD is being queued ABSTRACT The abstract pointer on the RAID is empty The abstract will be copied from the jukebox None Could not complete Could not complete Requeued DELETE file could not be deleted DELETE file could not be deleted Check permissions on RAID share Check permissions on RAID share January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 131 132 Message Explanation Action Current RAID The RAID share must be On the BP main window use Edit Shares Exception No RAID assigned to a RAID Group gt Network Location Manager to group Assigned assign the RAID share s to a RAID Group False Positive Copy File sizes on source and Determine if images are for filename Source destination don t match File not different patients filenames ource filesize copied filesize jukebox File copied was of s
123. d the Windows account that will be used for logging into the workstation has READ WRITE permission to those shares 5 3 Tasking If the Verifier is to be run on a daily weekly monthly schedule the SCHEDULED VERIFIER task will need to be assigned to the BP Server January 2012 Background Processor User Manual Rev 10 86 VistA Imaging MAG 3 0 121 5 4 Understanding Processing The process is 1 2 You select a range of IENs to be processed The Verifier steps through each IEN in VistA and validates the image pointer locations Full abstract and BIG types for both the RAID shares and archive devices jukebox The validation is done by physically checking the share for the existence of each file type There are two different types of checks e WhenaRAID file is not found the Verifier clears the appropriate pointer in VistA for that file type e Ifthe RAID file is found at the pointer location then no change is made to the database When a file is not found for an archive jukebox the Verifier searches all the online jukebox shares for the file If the file is found the archive pointer in VistA is updated to that new location 5 If the archive file is found at the pointer location then no change is made to the database The Verifier creates missing files when it finds other files that can be used to create these missing files The following table shows the specific file extensions needed to create a particular file
124. dy Instance UID UI 1 4 0020 000E Series Instance UID UI 1 1 1 2 840 5 9 7 67 216 5 59562 10144727 10002 3 0020 0010 Study IDASH 1 1 576 0020 0011 Series NumberAIS 1 1 20 0020 0013 Instance Number IS 1 1 1 0020 0020 Patient Orientation cSs 1 1 R 0020 0020 Patient Orientation cs 2 1 F 0020 0060 Laterality cs 1 1 unknown Text file MAG 2005 15485 0 MAGPATIENT 34587 0008277312 ABDOMEM VIEW 1 14860 RAD CR MAG 2005 1548 1 0 2005 04P 2 2 MAG 2005 1548 1 1 0 21547 20 1 MAG 2005 1545 1 2 0 21548 21 1 MAG 2005 1548 1 ADCM 20 1 1547 1 2005 1546 1 21 1 1548 2 2005 1546 29 3020301 101158 VIEW 3020221 1707 74 77 29401 13754 1 4 452 6989489 8548 1 51001 576 77 172 VistA Global Note the Study Instance UID is found in the parent file January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 149 SOP and or Study Instance UID are is blank the text file 0002 0016 Source Application Entity Title AE 1 1 DICOM TEST 0008 0005 Specific Character Set cs 1 1 ISO IR 100 0008 0008 Image Type cs 1 1 ORIGINAL 0008 eei pueda Type cs 2 1 SECONDARY 0716 50 Class UIDAUI 1 1 1 2 840 10008 5 1 4 1 1 1 0018 50 Instance UIDAUT 0008 0021 5 DateADA 1 1120010510 0008 0022 Acquisition Date DA 1 1 20010510 0008 0023 Date DA 1 1 20010510 0008 0030 Study Time TM 1 1 144727 000000
125. e Internal Entry Numbers IENs During the year many files will be retrieved from the jukebox and pointers updated in the database This will ensure that files on the RAID and the jukebox can be accurately located Large Image Share Population Events The Verifier should be run over the range of Image IENs that were copied back to the Image shares from the jukebox There may be occasions where files were not copied and incorrect file pointers set in the database with this large volume of files being moved to the RAID Image share or jukebox outages Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 The Verifier should be run after the resolution of any event that interrupted the flow of images to the jukebox The Queue Processor will attempt to copy files to the jukebox 3 times At that point it will indicate failure and begin processing the next entry in the queue Note These files reside ONLY on the Image shares and therefore MUST be copied promptly to the jukebox using the Verifier e Offline Platters When the jukebox is physically full and space is needed to add additional platters the OFFLINE IMAGE utility MUST be used See Chapter 9 Jukebox Archive in the VistA Imaging System Technical Manual prior to physically removing the platters This utility will mark the IENs as being archived and the Verifier will skip these while processing 7 6 Monitoring the BP Purge 7 6 1 Precautionary Guidelines
126. e Auto Purge process uses these parameters Purge Retention Days and Purge By 1 Select Edit gt BP Servers 2 Drag the PURGE task to the BP Server where the purge is to be run best if run on an Imaging server Click OK to close the window 4 Select Edit gt Purge Verifier RG Settings tab Set the following fields Field Setting Auto Purge Checked Express Purge Active Checked Scheduled Purge Active Unchecked PServer Reserve use the current value that is set on your site Purge Factor 2 used only with multiple active RAID Groups 6 Click OK to close the window When any share in a single RAID Group configuration has less than the Server Reserve free space the Purge will start and process all the active shares in that group On the multiple RAID Group configurations the Purge will start on the next selectable RAID Group when the free space on any share in the current RAID Group falls below the Purge Factor times the Server Reserve This Purge Factor is set to allow time for the purge to complete on that next RAID Group before the Queue Processor changes the Current RAID Group to that group The Express Purge setting described in a previous section will dramatically lower the time it will take to purge a share RAID Group Note The Queue Processor must be in the running state in order for the Auto Purge to run on the designated server i e the Start button must be clicked 3 5 2 Ver
127. e Long term storage of data or images A jukebox is the most common archive type presently used at sites Archive Appliance A brand of enterprise level archival storage software Auto Write update Process that checks each Image share and designates the share with the most free space as the current write location The check for space is done after 100 Writes to the share or after 20 minutes since the last check whichever comes first BP Acronym for the Background Processor in the VistA Imaging System BPWS Former term for a Background Processor Workstation now called a Background Processor Server Cache Short name for the VistA Magnetic Cache or VistA Imaging Cache alternative terms for RAID See Raid Contrast with Cach Cach Commercial product name of the software used to install and set up the VistA database Contrast with Cache CBOC Acronym for community based outpatient clinic Critical low Email to alert key personnel that free space on an Image share has message fallen below the Server Reserve watermark Current Queue pointer Queue type specific database reference to the next file copy create or destroy request Current Write Reference to the network share where images and associated files are location CWL stored that are newly acquired or retrieved from the jukebox DFN Internal entry number IEN of a PATIENT file 2 entry 152 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121
128. e mail messages for a specific alert that user user group can be removed using the following steps 1 From the Queue Processor menu bar select Edit gt Mail Messages to open the Mail Groups window or select the Mail Messages tab 2 Right click a user mail group and select Delete Group Member from the popup menu VistA will automatically be updated to reflect the change 3 4 1 6 Specifying Properties for Mail Groups 1 From the Queue Processor menu bar select Edit gt Mail Messages to open the Mail Groups window or select the Mail Messages tab 2 Right click a mail group and select Properties from the popup menu displayed Note This popup menu can also be accessed from the keyboard by using Shift F10 26 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 9 UJ Main Site Parameters Mail Messages 1 Groups Mail Groups IMAGPRO Add Remote Mail Member 25 MAG GB Mor Delete Group Member MAG GB Properties MAG B VI BP ueue Processo 3 When the Mail Group properties dialog box is displayed enter the data 4 Click OK in the dialog box and then Apply in the Mail Groups window Description This defines the recipients of Image installation messages Organizer IMAGPROVIDERONETWOSIX ONETWOSIX Type public Restrictions Unrestricted IMAGPROVIDERONETWOSIX ONETWOSIX MEMBER GROU
129. ection in the Queue Processor window 4 6 1 1 BackProc Log E BP Queue Log Microsoft Internet Explorer File Edit Favorites Tools Help Q Back x seach Favorites iy amp C Program Files vistA Imaging BackProc log BackProc BackProc2009_10_29_01 html Date Time Event Queue Ref Message Path 10 29 2009 12 30 52 PM BP Version 30 1 39 21 10 20 2009 12 30 52 05 Win 5 2 3790 10 29 2009 12 30 52 PM Work Station VHAISWAVHITEVM2 10 29 2009 12 30 52 Vista Imaging Install 3 0P39 10 29 2009 12 30 52 PM Vista vhaismwhitevm1 10 29 2009 12 30 52 PM Raid Verify Checking File Server Space 10 29 2009 12 30 54 PM JukeBoxC acheSize JBCache Percent Space Available 98 10 29 2009 12 30 54 PM Jukebox 294 WVHAISWAUHITEVMTIMAGET1 DMY0x113DMOO1167 T G WV HAISWWHITEVMTUIMAGEJB1PDMOO1157 T 6A 10 29 2009 12 30 55 PM Jukebox 294 Jukebox copy not ovenmritten 10 20 2009 12 30 55 PM JUKEBOX 294 WVHAISWAVHIT EVM IMAG 11DMOO1167 TXT WVHAISWWIHITEVMTUIMAGEJBTPNDMOO 1167 TXT 10 29 2009 12 30 55 PM JUKEBOX 294 TXT Not copied 10 29 2009 12 30 55 PM Jukebox 294 AVHAISWAVHIT EVM IMAG E1 D 110 M001 167 ABS W HAISWWHITEVMTIMAGEJBTPDMOO1167 ABS 10 29 2009 12 30 55 PM Jukebox 294 Jukebox co
130. ed and the IMAGE file 2005 record has been moved to the IMAGE AUDIT file 2005 1 Address amp C Program Files VistA Imaging BackProc log verifier NoArchive2009_08_18_01 html Filename 2005 1 000003 5 1 000003 1 000004 756 1 000004 1 000005 756 1 000005 1 000006 756 1 000006 1 000007 756 1 000007 1 000008 756 1 000008 000010 Description Filename Name of the missing file 2005 1 If the column contains 2005 1 then the Image has been deleted and the image information is in the IMAGE AUDIT file 2005 1 If the column is blank the file is missing from the RAID and archive storage and must be restored using one of the methods listed above Note When the 2005 1 column is blank the file is missing and must be recovered from the backup tapes or other means January 2012 Background Processor User Manual Rev 10 99 VistA Imaging MAG 3 0 121 These files must restored using one of the following methods e Restore from backup tape s e Resend from the gateway Re capture on the Capture workstation e File restore from platter on the jukebox If the missing file cannot be located the Patient ID information and provided information for these missing field s should be sent to the hospital staff persons for their records 5 7 1 3 ScanError Log File
131. elow the Server Reserve Disable the Auto Write Location Update option Set the write location manually to a share with cache space available share has adequate free space create a second BP Server and manually launch a Purge in Chapter 6 Purge to run on all shares When the Purge has run and generated free space on a share set the Write location manually to that share 8 1 4 Not Enough Process Memory Close all the applications and reboot the server If the problem persists contact the National Helpdesk 8 1 5 Not Enough Write Cache Available This message refers to the DiskXtender cache on the jukebox and indicates there is no free space on the jukebox share or for Archive Appliance sites a possible space issue exists e Verify the share is accessible Follow the steps in section 8 7 7 Network Connection to troubleshoot e Click the Extended Drive in DiskXtender to see if there is free space available Also use Windows Explorer on the JB server to see if Windows is properly reporting free space e Check the Move Group within the DiskXtender application to see if there are platters with available space If not add additional optical platters to the Move Group See the DiskXtender User Manual e Runa Drive Scan on the share See the DiskXtender User Manual January 2012 Background Processor User Manual Rev 10 129 VistA Imaging MAG 3 0 121 8 2 Queue Processor 8 2 1 Startup 130 Message Exp
132. er for each IMPORT entry Import Queue Lookup for IMPORT queue entry in the IMAGE BACKGROUND QUEUE file 2006 03 This number is displayed in the Queue Processor GUI in the Process Queue IEN column e g IMPORT 1234 ACQUISITION SESSION _ Logs all pertinent data when a queue entry is processed file 2006 041 for IMPORT queue entry in the IMAGE BACKGROUND QUEUE file 2006 03 QUEUE field Sequence of events for processing the queue entry 01 TRACKING ID Unique identifier for the IMPORT entry field 02 ACTIVITY field Category of the session output 1 TIME field 2 Time stamp for processing step QUEUE STATUS _ Status logged for each processing step field 3 IMAGING WINDOW Displays error information when an attempt to queue an SESSIONS file IMPORT failed 2006 82 IMPORT QUEUE file Displays parameter information that was initiated by the 2006 034 remote source Note If there are conflicts caused by the volume of imports being processed it may be necessary for the IMPORT queue to hold pause and try processing the IMPORT queue again The IMPORT queue logs this event in the XTMP global and is held there for 30 days 3100702 0 3100801 3100702 IMPORT Trackid failure 3100702 084918 Queue ptr 21207424 De queue Holding FIVE sec for Station amp 508 3100702 094228 Queue ptr 21208716 De queue Holding FIVE sec for Station amp 508 3100
133. es are archived as HTML files and have the year month day and sequence number imbedded in the file name as shown in the right pane of the window Progra n agingBackProc log BackPro 8 File Edit Favorites Tools Help ay Q Back 7 P search 0 Folders 5 gt 19 Address T gt Go Name BackProc2009 07 20 html 2KB HTML Document 7 20 2009 12 33 PM Folders Attributes El vista packProcz009_ 08 07 html 2KB HTML Document 8 7 2009 8 58 AM BackProc2009_08_13 html 2KB HTML Document 8 13 20098 34 AM e Imaging amp BackProc2009 08 14 html 5KB HTML Document 8 14 2009 10 53AM C BackProc amp BackProc2009 08 14 01 html 21KB HTML Document 8 14 2009 3 14 PM BackProc LOG 5 Text Document 8 14 2009 3 40PM A BPError LOG Text Document 7 20 2009 12 32 PM A If more than one log file is run on the same day the system adds a sequence number such as 01 following the date in the file name For multiple runs on the same day the highest sequence number is the latest log file run for the day The Queue Processor produces multiple log files for a processing run Each file contains different information 68 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 BackProc log records all activity in the Event Log s
134. essor User Manual Rev 10 143 VistA Imaging MAG 3 0 121 Appendix File Formats The BP Processor can process the following file formats typically used in the VistA system File Extension ABS Description A graphics file used to contain abstract data The file can normally be accessed through the VistA Imaging Clinical Display application ASC A text file containing text in ASCII code The file can normally be accessed by most text editors on multiple platforms AVI BIG A video file containing compressed data and normally accessed by Windows based applications An image file containing full diagnostic resolution data normally accessed through the VistA Imaging Clinical Display application BMP An image file containing an uncompressed bitmap of the image The file is normally accessed through Windows based applications BW An image file containing an uncompressed or compressed bitmap of the image The images can be either monochrome or color and are generated by Silicon Graphics Inc equipment The file can normally be accessed through the VistA Imaging Clinical Display application DCM An image file created using the Digital Imaging and Communications in Medicine DICOM format These files will normally contain both image data and metadata about the patient and the image The file can be accessed on multiple platforms but can require the use of specialized readers to separate and properly dis
135. eter is missing from IMPORT IMPORT no RAID pointer is set in VistA for the image Resend image from import source Resend image from import source Problem renaming log file filename Could not rename log file to a versioned copy Check permissions on the existing folder files queue pointer Size Mismatch queue type copy not File sizes on source and destination don t match File not Determine if images are for different patients overwritten copied SetFileTime Failed Could not set Access date on the None log file The jukebox copy filename does DELETE Could not find the file None not exist attempting a copy on jukebox shares Try to copy from RAID shares to jukebox The RAID share is not on line IMPORT The Image share is not available Check the permissions on the image share indicated The src filename to dest filename copy failed EXPORT file could not be copied Check for network connectivity Check permissions January 2012 VistA Imaging MAG 3 0 121 Background Processor User Manual Rev 10 133 8 3 Message Explanation Action The VistA cache file filename not found DELETE Could not find the file on RAID shares to delete None This Server is not yet configured A BP Server has not been associated with this server Create a BP Server for this processor Unable to copy to the Jukebox Not enou
136. f several images that the IMPORT queue can import from external applications VISN Veterans Integrated Service Network s VistA Acronym for Veterans Health Information System Technology Architecture VistA Imaging Also called VistA Magnetic Cache an alternative term for RAID Cache See RAID Contrast with Cach VistA Imaging Same as VistA Imaging Cache Contrast with Cach shares VMC Acronym for VistA Magnetic Cache an alternative term for RAID See RAID Contrast with Cach Win32 The set Microsoft Windows operating systems internal function calls which support all operating system activity WORM Acronym for Write Once Read Many January 2012 Background Processor User Manual Rev 10 155 VistA Imaging MAG 3 0 121 Definition Write Once Read Once written to the disc data is only available for reading and cannot Many be altered Jukeboxes should be e WORM DG for Data General Jukeboxes under OpenNetware e WORM PDT for Pegasus Jukeboxes WORM OTG for OTG Disk Extender Note WORM DG and WORM PDT are for backward compatibility only 156 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 157 Index Free Space DICOM Messages 21 Server Reserve 5 18 31 34 72 78 105 107 128 508 Compliance 83 A ABS VC 97 100 Abstract Files 30 A
137. gh write cache available Zero size queue_type copy NOT overwritten JUKEBOX The jukebox share is not available or is full Zero size file on the destination could not be overwritten Add new platters to the jukebox Determine why the jukebox share is full Possibly add new platters to the jukebox Remove zero size file No Connection to VISTA The VistA Access and Verify Update the Access and Verify codes of the user or service codes on the BP Site parameter account are invalid window Verifier 8 3 1 Start Run 134 Message About to exit without processing 0 Broker Connection to server could not be established CC createcontext MAG WINDOWS could not be established IbCacheShare items Count lt 1 MAGQ SHARES Invalid Input Range jukebox shares are not setup This workstation is not currently setup as a Background Processor Background Processor User Manual Rev 10 Explanation There no records within the range VistA RPC Broker is not currently in a listening state OR the application has timed out The user does not have the MAG WINDOWS menu option assigned There are no online non router VMC shares The From and To values entered in the Range are not correct e g Start 0 End 0 The jukebox share s are offline or don t exist in the NETWORK LOCATION file 2005 2 There is no BP Server set up for this machine VistA Imaging MAG 3 0 121
138. hat is 1 Purge Error log file 116 Purge Factor 31 32 34 Purge log file 115 Purge queue by type entries 82 Purge Rate 31 Q Queue Management by Type option 63 Queue Manager active failed status counts 39 description 39 priority order 39 window 39 Queue Processor description 38 57 setup guidelines 57 starting the application 64 tasking 58 understanding processing 63 What is 1 Queues ABSTRACT 60 accessing failed Import Queue properties 41 active queue pointer 39 assigning to BP Servers 11 concept of 58 corrupted entry 41 DELETE 62 EVAL 63 62 IMPORT 61 JBTOHD 59 JUKEBOX 61 PREFET 60 purging 40 re queuing 40 setting partition 41 R RAID Groups adding 54 advance settings 37 automatic RAID Group advance 5 current 17 January 2012 Background Processor User Manual Rev 10 161 VistA Imaging MAG 3 0 121 description 4 guidelines for setting parameters 38 guidelines on shares 4 in Network Location Manager 43 running the Scheduled RAID Group Advance 38 setting parameters for RAID Group Advance 38 Write Location 17 Range 91 92 Rehabilitation Act of 1973 83 Reports See Log File Emails and Screen Generated Output Re queuing a failed image 40 Re queuing entries to be kept 82 Retention Days DICOM Messages 21 Retention Days HL7 Modality Work Lists 21 Retention days configuring 30 ROUTE DIC
139. he Imaging Installation Guide to the Windows account that will log into the BP Server 2 3 2 VistA Security The Background Processor requires authentication to VistA via a Broker connection to function This account must have the following permissions e MAG SYSTEM security key e MAG WINDOWS secondary menu option Since it is essential that the Background Processor be capable of continuing to perform its function without human interaction a site can establish a special service account for which the access and verify codes will not expire When a Background Processor loses a network connection as a result of an interruption it is important that the Background Processor have access to a continuously available service account to reestablish connectivity without user interaction See the section 5 3 in the DICOM Gateway Installation Guide for information on how to initially set up this account if not done already e The VistA Imaging service account for VistA should be assigned one account per division This is required because each division is defined by an entry in the IMAGING SITE PARAMETERS file 2006 1 Note When an end user signs into the VistA database the user s default division is used or the Division selected at log on when an end user has multi divisions assigned Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 The credentials for the VistA Imaging service account for VistA should be en
140. he Background Processor Usage and Maintenance of RAID Groups A RAID Group is a group of one to many shares that will be recognized as a unit within the Imaging storage network Its purpose is to reduce the number of active storage shares in order to facilitate quicker tape backups both incremental and full Newly acquired images are distributed evenly among all the shares within a RAID Group aN Image Group CE 9 P d image Group A Current Write Imag23 Image5 Group cili p 17139 62 Imaga S Image Group m Imag25 RAD Group RA E Greup 3 RAD Group C Visual example of a RAID GROUP with Group C set as the current write location Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 1 5 1 RAID Group Guidelines e Distribute the shares among multiple RAID Groups e Fill the shares in each group to the Server Size then switch the current RAID group to the next e New image files will be distributed over all the shares assigned to that group e Nightly incremental tape backups as well as monthly quarterly tape backups must be done only on active RAID Groups e When it has reached capacity a final full backup should be done on all the shares and nightly incremental tape backups and monthly quarterly tape backups started on the next current write group A RAID Group Advance can be scheduled as follows o You
141. he IMAGE file 2005 and or IMAGE AUDIT file 2005 1 where BIG image is located The extensions of all files on the jukebox will be listed VC Full The DISK amp VOLUME MAGNETIC 2 value for the share the IMAGE file 2005 and or IMAGE AUDIT file 2005 1 where FULL image is located VC Abstract The DISK amp VOLUME ABSTRACT 82 1 value for the share in the IMAGE file 2005 and or IMAGE AUDIT file 2005 1 share where abstract image is located VC Big The BIG MAGNETIC PATH 102 value for the share in the IMAGE file 2005 and or IMAGE AUDIT file 2005 1 where BIG image is located January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 95 Description CWL Image share that is the current write location This will change automatically if the AUTO WRITE LOCATION UPDATE option is selected The check for space is done after 100 Writes to the share or after 20 minutes since the last check whichever comes first JB Path 1 The IEN for the entry in NETWORK LOCATION 2005 2 file of first alternate jukebox JB Path 2 The IEN for the entry in NETWORK LOCATION 2005 2 file of second alternate jukebox status bar at bottom Parameters for this run are listed Note When the IEN range includes files that have been saved in a flat file structure there will be a noticeable increase in the time it takes to complete the scan The
142. he count by file type Purged Files Abstract Full Image Big Text Photo ID Foreign Breakdown by file type of files purged Note Legend on the right displays the count by file type Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 6 6 Reports Three types of reports are produced to notify you of important occurrences e Log files e Emails e Screen generated output 6 6 1 Log Files New log files are created as HTML files at the beginning of every session HTML files are viewable printable and searchable By default setting the BP Purge log files reside in the C Program Files VistA Imaging BackProc log purge directory You can access these files by e Selecting File gt Open Log on the BP Verifier menu bar e Using an internet browser They can be imported into an Excel spreadsheet Log File Format Purge log files have the year month day and sequence number imbedded in the file name as shown in the right pane of the window Folders vista af amp lPurgezo09 08 18 html Broker amp Purge rrorz009 08 18 html 3 Imaging amp PurgeError2009 08 18 01 html BackProc Help El log BackProc o O verifier If more than one log file is run on the same day the system adds a sequence number such as 01 following the date in the file name as shown for the PurgeError2009_08_18_01 html file For mul
143. he hospital users in the Mail Groups section is not displayed until you click in the area shown above The list may take a few minutes to appear depending on the number of end users defined in the site s VistA database The following is an example of a displayed list of mail users ee 222222222 3 4 1 2 Guidelines on Adding Mail Groups Only active VistA users can be added as members to mail groups An active user has an IN basket defined in VistA Important When you add a new member to a mail group use the same email address as the one in the domain which may or may not be the same as the user s va gov address This group is initialized during the install process e The installer is automatically added as a local member The GIMAGING DEVELOPMENT TEAM FORUM VA GOV is added as a required remote recipient to comply with the Food and Drug Administration requirements e tis recommended that the local VistA Imaging ADPAC Imaging Coordinator and any Imaging managers be added as a member as well as any network administrators who are responsible for the support of the VistA Imaging system e tis recommended that a local text pager recipient be added as a remote member The pager service needs to provide email pager response The standard email addressing format is supported by this system mail domain Only individuals with the MAG SYSTEM security key will be displayed in the look
144. ication The GCC queue processor is having diffi location The last copy attempt failed 3 VHAxxxx400 GCC24 Cannot connect to the will occur in 6 hours 4 6 25 Get Next RAID Group Failure This message is sent by the Queue Processor when the Scheduled RAID Advance is set and it cannot advance to the next RAID Group perhaps because all the shares in the group are set to READ ONLY or there is a connectivity problem Example Subj Get Next RAID Group failure 431173 10 27 09813 51 4 lines From VistA Imaging Get Next RAID Group failure basket Page 1 New SITE IMGxxxx MED VA GOV DATE Oct 27 2009 13 51 46 EST Production Account 0 The get next raid group function failed 72 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 4 6 2 6 Image Cache Critically Low This message is sent by the Queue Processor when it determines that the cache is below the Percent Server Reserve factor and the Auto Purge has not been set Example Subj Image Cache Critically Low at 31158 10 07 09 21 40 22 lines From BACKGROUND USER I In IN basket Page 1 SITE IMGDEMO1 MED VA GOV DATE Oct 07 2009821 40 01 EST SENDER SALT LAKE CITY Imaging Background Processor Total Cache Free VistA Imaging RAID storage is Critically Low gigabytes Total Cache Available 2131 gigabytes The Automatic Pu
145. ification Intervals etes 23 39 13 Field Descriptions ivit es 23 Contieurms M il OEOUDSL 24 3 4 1 Groups WOW 24 3 4 1 1 Displaying Mail 25 3 4 1 2 Guidelines on Adding Mail Groups eere 25 3 4 1 3 Adding Members to Mail Groups 23 3 4 1 4 Adding Remote Members to Groups eee 26 3 4 1 5 Deleting Members from Mail Groups eene 26 3 4 1 6 Specifying Properties for Mail Groups eene 26 Configuring the Purge Verifier and RAID Group Advance Settings 28 SPU SSS CUT SS s pat n in 29 3 5 1 1 Guidelines for Setting Retention Days on Files for the 29 3 5 1 2 Configuring the Retention Days Settings 2 30 3 5 1 3 Configuring Scheduled Express Purge Settings 31 3 5 1 4 Configuring Purge Date Criteria Settings ees 32 3 5 1 5 Running the Scheduled 33 3 5 1 6 Running the Auto 33 3 002 Verifier Ae UIT ss 55 ecg he sak hh al tac dE EE 34 3 5 2 1 Scheduled Verifier Settings MR 3
146. ifier Settings The Verifier validates image storage pointers in VistA by checking the physical locations of those pointers to ensure the file s exist on the specific storage media To maintain a valid database corrective action is taken when these physical files are not found on the media In addition to these file checks the Verifier examines the integrity of the imaging records in VistA Any corruption is reported in the log files 34 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 3 5 2 1 Scheduled Verifier Settings Scheduled Verifer Active Check Text Files Last Verifier Date Frequency in days Next Verifier Date 7 20 2009 Veriier Time 2400 Last Verify Server Field or Checkbox Description Last Verify BP BP Server on which the Verifier was last run Display only set Server by application Scheduled Verifier Active Enables scheduling the Verifier Check Text Files Read text files on the RAID shares and determine if 1 the file is binary or unreadable 2 there are unprintable characters in the file 3 The SSN does not match the one in VistA 4 SOP Instance UID mismatch with VistA 5 Study Instance UID mismatch with VistA 6 SOP Instance UID and or Study Instance UID are blank 7 SSN in the top part of the text file does not match the bottom Frequency in days Number of days added to the date of the last t
147. ile 2005 and or in IMAGE AUDIT file 2005 1 where FULL image is located Other file extensions on this share are also listed ABS VC PTR The DISK amp VOLUME ABSTRACT 22 1 value for the share in the IMAGE file 2005 and or IMAGE AUDIT file 2005 1 where abstract image is located Other file extensions on this share are also listed 98 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 Description BIG_VC_PTR The BIG MAGNETIC PATH 102 value for the share in the IMAGE file 2005 and or IMAGE AUDIT file 2005 1 where the BIG image is located Current_Write_PTR Image share that is the current write location This will change automatically if the AUTO WRITE LOCATION UPDATE option is selected The check for space is done after 100 Writes to the share or after 20 minutes since the last check whichever comes first JB ALT 1 Network Location of archive jukebox If a site has 2 or more 2 3 jukeboxes then the second third etc are the alternate jukeboxes 5 7 12 NoArchive Log File The NoArchive log file contains image file names that are missing on the jukebox and could not be created from existing files and or could not be found on the RAID The Verifier examines both the IMAGE file 2005 and the IMAGE AUDIT file 2005 1 for missing files The 2005 1 column shown below indicates those missing files that have been delet
148. iledate Purge Criteria EvalCriteria File was deleted See Section 6 4 None NOT PURGED filename filedate Purge Criteria Silent Login attempt Broker was disconnected Auto None login is initiated Start Date failure Problem with Date of Last Purge on Scheduled Purge Contact IRM to clear the record in the Imaging Site Parameter file Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 January 2012 Background Processor User Manual Rev 10 141 VistA Imaging MAG 3 0 121 Appendix Broker Server Configuration The BP communicates with the VistA database by using the VistA RPC Broker The following steps briefly explain the installation of the RPC Broker Client Agent software For more detailed information see the RPC Broker Installation Manual 1 2 Log in to your workstation as an administrator Install the RPC Broker client agent software Run XWB1_xWS EXE and follow the setup wizard Answer Yes when given the option of running the Client Agent program on startup Log in to the workstation as an administrator start the Registry editor Start gt Run gt Regedit and navigate to HKEY_LOCAL_MACHINE Software vista Broker Servers Create a new string value Edit New String Value and use the remote server name and port number as the name of the value Note Separate the name and the port number with a comma 2 Registry Editor Registry Edit View Favori
149. ime 0 00 03 DATE 3091210 Installed by INSTALLER Install Name MAG 3 0 39 Distribution Date 3091005 VistA Imaging V3 0 Patch 39 Test 22 10 05 2009 11 16AM 2009 11 16 02 4 6 2 9 Monthly Image Site Usage Created on Oct 05 This message is sent when the monthly site usage report 15 finished gathering information At completion the task is re queued for the next month Example Subj Monthly Image Site Usage SALT LAKE CITY 660 Sep 2009 31135 10 01 09 04 01 143 lines From IMAGPROVIDERONETWOONEFOUR ONETWOONEFOUR Page 1 SITE SALT LAKE CITY 660 Reporting Period Sep 01 2009 Sep 30 2009 DATE OCT 01 2009 04 01 03 EST DOMAIN IMGxxxx MED VA GOV 2005 ENTRIES 17798 2006 81 ENTRIES 5 WS DIS VERS 3 0 59 31 Win XP 5 1 2600 1 WS DIS VERS 3 0 72 30 1 Server 5 2 3790 1 WS CAP VERS 3 0 72 30 Win XP 5 1 2600 1 WS VR VERS 3 0 41 17 Win 5 1 2600 2 74 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 4 6 2 10 Photo ID Action This message is sent by the Queue Processor when processing a GCC queue that was triggered from a Photo ID image Example of the message when the PHOTO ID COPY entry is not properly defined Subj Photo I D Action 31190 10 27 09 08 57 7 lines From VistA Imaging PHOTO ID ACTION basket Page 1 New SITE IMGxxxx MED VA GOV
150. ime the Verifier application ran to determine the next time the Scheduled Verifier should be run Last Verifier Date Date when the Verifier was last run Next Verifier Date Date of the next scheduled Verifier will run based on the Frequency in days parameter Verifier Time Time of day when the Verifier will run 3 5 2 2 Guidelines for Setting Parameters for the Scheduled Verifier The Scheduled Verifier should be setup to run nightly It will verify the integrity of any image records not validated since the previous Verifier run Manual or Scheduled It is suggested that the Verifier be run manually over the entire range of image records before incremental Verifier runs are started The application that runs for the Scheduled Verifier is the same as the Manual Verifier Reference the Manual Verifier above for specific information about the GUI and log files January 2012 Background Processor User Manual Rev 10 35 VistA Imaging MAG 3 0 121 The following guidelines for using the Scheduled Verifier will help maintain the integrity of the Imaging records in the VistA database Important If the PC that has Scheduled or Auto events is not a server class the task will not start Setthe Active check box to enable scheduled runs of the BP Verifier The scheduled runs of the Verifier will only check the most recent VistA records of new images that have been created since the last Scheduled Verifier run Do not select the
151. in the Failed category In most cases the cause of the failure can be corrected and the Failed entry re queued with success 1 Right click a failed entry in a task and select Re queue from the popup menu as shown in the example Note This popup menu can also be accessed from the keyboard by using Shift F10 lt Active 18 Re Queue p EVAL Purge Queue Active 992 Set Queue Partition coo 40 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 2 Click Yes in the confirmation message shown 2 Do you wish to Re Queue all ABSTRACT queues with a status of NOT_PROCESSED 1 No The queue entry will move from the Failed queue to the Active queue for that task The queue counts will be updated 3 6 4 Setting a Queue Partition Each task has an active queue pointer that designates the next entry to be processed This pointer can be manually moved to begin processing at another location in the queue A typical situation may be when a queue entry is corrupted The queue pointer can be moved to the next entry where processing continues with the rest of the queue entries for that task 1 To move the active queue pointer Set Queue Partition right click a failed entry in a task and select Re queue from the popup menu as shown in the example Note This popup menu can also be accessed from the keyboard by using Shift F10
152. in the VistA database Each of the boxed areas in the window is described below site calf Imaging Site Parameters imaging Site Parameters Messages Mail Groups Purge Veritier RG Settings BP Servers Queue Manager Clinical Workstation Administrative Current Namespace s c Use Capture Keys v RAID Write Location gt Timeout Windows Display co Generic Carbon Copy Timeout Windows Capture 45 Timeout VistARed 60 CumentRAID Group RG SLc3 Default MUSE Site fi 4 i Site Code A Default User Preference 5 SETTING gt Associated Institutions VistARad Grouping Service Accounts COLUMBIA MO COLUMBIA MO SALT LAKE DOM KANSAS CITY MO Windows Usemame memesterBPUser Windows Password Storage Functions Jukebox Write Location WOAMOTG site name gt Server Reserve VistA Verify Auto Write Location Update interface DICOM Gateway Write Location Multiple Namespace File Types gt 2M S E DICOM Gateway Interface Switch Update V p Velereader Retention Days HL Modality Worklists 30 ISTASIESERVICE zi Free Space DICOM Messages fi 5 Timeout TeleReader 121 Retention Days DICOM Messages 123 X Help 16 Background Processor User Manual Re
153. ing BP Server to the VistA Imaging System 10 2 5 3 Assigning Tasks Queues to a BP Server 11 2 5 4 Removing a BP Server from the VistA Imaging System 13 2 5 5 Specifying the Log File Location and Size sese 13 Chapter3 Configuring the A pplicationi ascscccsscscesssovsecnssssssosseeveossessesocacsvasenassesvosstenseesesesss 15 RTT 15 3 1 1 Overall Guidelimes 15 3 2 Configuring the VistA Imaging Site Parameters 16 3 2 1 Imaging Site Parameters Window 16 3 2 1 1 Administrative SOLUTES 17 3 2 1 2 Storage Functions TRA 18 3 2 1 3 Clinical Workstation Settings 19 3 2 1 4 Service Accounts SEU MG Sag age uda aS e REA rye ene 20 325 DICOM Interface Settings Eon es Se UE 2 3 9 Configuring Mail Messages uec ve een 22 231 Messages WINGO We sees ette eh dads sere Se REN RE 22 January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 3 4 33 3 6 3 7 3 3 1 1 Displaying Mail Users tee 22 3 3 2 S Adding Names ascolto steep ordi e 23 219 1 3 Removing NAMES e d 23 3 3 1 4 Not
154. ion references in the IMAGE file 2005 are physically checked to determine the existence of the file s on their assigned Imaging share s and jukebox If any file excluding TXT is missing from the Image shares the pointer will be cleared in the IMAGE file 2005 record If all files are missing on any on line jukeboxes the jukebox pointer will be cleared The Verifier will set the jukebox pointer if any of the files in the set are found on the current or alternate jukebox The Verifier will also look at the IMAGE AUDIT file 2005 1 to ensure the file set exists at the location s specified in this file 5 5 1 2 Patient Integrity Patient related values in the IMAGE file 2005 are checked for consistency within the group Image entries and the associated report files The following table lists the integrity issues that will prevent their respective images from being displayed The following integrity error messages will be generated when the image is retrieved for viewing Message Generated Explanation No Image Ptr in AP The Clinical Association Report AP for this image does not contain an image entry that points back to this image GP has no images The image series does not contain any images Group Parents GP are containers for an Image series A group parent with NO group objects GO is an invalid condition Conflicting AP amp Image DENs The patient file reference DEN in the Clinical Association Report AP doe
155. ir entries can be purged re queued e Active Queues only the Purge option is available and only for the JBTOHD GCC PREFET and EVAL queues The Requeue option is not available Select View gt Purge by Queue Type from the main menu bar to view this window site Queue Management by Type 5 x Failed Queues Active Queues Abstract 0 Delete 0 r 0 Import 0 JBTOHD 0 Jukebox 7 Prefet 0 Eval 0 Select an Action Purge Requeue 1 Cancel 2 Help January 2012 Background Processor User Manual Rev 10 83 VistA Imaging MAG 3 0 121 4 6 3 5 508 Compliance The purpose of this option is to implement section 508 of the Rehabilitation Act of 1973 as amended 29 U S C 794d Section 508 requires that when Federal agencies develop procure maintain or use electronic and information technology Federal employees with disabilities have access to and use of information and data that is comparable to the access and use by Federal employees who are not individuals with disabilities unless an undue burden would be imposed on the agency Section 508 also requires that individuals with disabilities who are members of the public seeking information or services from a Federal agency have access to and use of information and data that is comparable to that provided to the public who are not individuals with disabilities unless an undue burden would be imposed on the agency Select View gt
156. is menu option must be executed on a regular basis and should be tasked using the VistA TaskMan Management menus The BP Server Monitor can be configured with site specific values when the utility is scheduled using the Kernel Scheduling menu explained in the next section The site configurable parameters are MAGMIN determines the lapse time between processing tasks If the variable is undefined then the default value is 15 minutes If an active queue has not processed within specified minutes then a mail message is sent MAGFQ determines if failed queues per queue type have reached this limit If the variable is undefined then the default value is 1 000 If failed queues are above this limit then a mail message is sent MAGEVAL determines if EVAL queues have reached this limit If the variable is undefined then the default value is 10 000 If EVAL queues are above this limit then mail message is sent 7 3 Scheduling the BP Server Monitor 7 31 Example of Scheduling If MAGMIN minutes have transpired since processing the last queue and there is another queue to be processed then a MailMan message with subject text BP Queue Processor failure will be sent Recommendation Schedule this task to run every 10 to 15 minutes site configurable January 2012 Background Processor User Manual Rev 10 123 VistA Imaging MAG 3 0 121 7 3 2 Tasking BP Server Monitor Menu Options Recommendation Task the menu to r
157. istA could not be updated Exit from the Purge and restart Validate the IEN record exists in VistA Findfirst failed filename The directory traversal failed Exit from the Purge and restart January 2012 VistA Imaging MAG 3 0 121 Background Processor User Manual Rev 10 139 140 Message Explanation Action Log File Archival reset to The logs files are now being None FilePath2 instead of FilePath stored at another location Login Message Broker After a Broker disconnect the application was able to None Reconnection Successful reconnect to VistA F After a Broker disconnect the Tokin Mesas Fanning gt application tries 3 times to None minutes and will then retry reconnect to VistA Login Message Silent Login attempt failed After a Broker disconnect the application was not able to reconnect to VistA Check network connections NewCreationDate SetFileTime Could not set the date of last Failed filename Accesses on filename None D Broker disconnected Check VistA for error trap NOT Purged criteria EvalCriteria NOT PURGED File was not deleted See Section None JUKEBOX QUEUED filename date 6 4 Purge Criteria Problem renaming log file filename gt filename2 Could not rename log file to versioned log file name Check permissions Purge Criteria EvalCriteria See Section 6 4 Purge Criteria None filename f
158. ithin the local area network or external to the local area network This protocol was requested by Indian Health Service IHS and called for the exported file to have the patient s DFN included in the file name so that the operator could correctly assign a patient photo IDs In order to activate this functionality create one or more GCC locations to receive the exported photo IDs using Network Location Manager Edit the protocol in the IMAGE ACTIONS file 2005 86 using FileMan Example VA FileMan 2 lt 0 Select OPTION ENTER OR EDIT FILE ENTRIES PUT TO WHAT FILE 2005 86 ACTIONS 2 entries EDIT WHICH FIELD ALL ACTIVE THEN EDIT FIELD TAG THEN EDIT FIELD ROUTINE THEN EDIT FIELD TYPE multiple EDIT WHICH TYPE SUB FIELD ALL enter THEN EDIT FIELD EXPORT LOCATION THEN EDIT FIELD lt enter gt STORE THESE FIELDS IN TEMPLATE enter Select AGE ACTIONS NAME PHOTO ID COPY ACTIVE Y YES TAG PID enter ROUTINE MAGQBGCC enter gt Select TYPE PHOTO 10 lt enter EXPORT LOCATION GCC21 this field points to the NETWORK LOCATION 2005 2 file select the network location to receive the exported image file the TAG and ROUTINE fields are predefined by VistA maging patch MAG 3 0 39 with the routine to be used by the HIS The files created at the exported location will be named using the patient DFN If a site wishes to change this they can u
159. ize zero File of size zero created then deleted IMPORT The file size is zero MAKEABS file of zero length was created by Mag MakeAbs exe It was deleted Resend image from import source Log a Remedy ticket File was not found IMPORT file does not exist on the image share Resend image from import source filename Source file does not exist Could not find source file Run Verifier to correct VistA pointers fileshare Cannot connect to the Export Share EXPORT Cannot map to the remote share Check for network connectivity Check permissions ForceDirectories failed DELETE could not create directory on jukebox share Check permissions on jukebox share Image File type filename ext 15 an Unsupported Format ABSTRACT The Full file is not a supported Imaging file type So the abstract cannot be created Examine the foreign file and determine if the extension was misnamed Jukebox is not available filepath Volume label Jukebox sourcefile unavailable JUKEBOX the jukebox share 15 not available JBTOHD There is no abstract file on the jukebox The abstract pointer in VistA is not set Ping the jukebox server Check the jukebox share permissions None JUKEBOX queue pointer file extension Not copied JUKEBOX Alternate file extension i e was not copied Check file permissions Login Message Pausing 3 minutes and will then
160. k the following DICOM parameters on all your Gateways On Demand routing does not require these parameters to be set Will this computer be a Routing Processor NO Will this computer be part of a System where autorouting is active NO 76 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 4 6 2 16 VI BP Queue Processor Failure This message is sent by the Monitor Background Process when a user defined threshold for an activity is exceeded Example Subj VI Queue Processor failure 31186 10 27 09 06 45 6 lines From VistA Imaging basket Page 1 New SITE IMGDEM0O1 MED VA GOV DATE Oct 27 2009 06 45 EST VistA Imaging BP Server ISW xxxxx LT has failed to process a JUKEBOX queue for 25 minutes The last date time a queue was processed was on Oct 26 2009 11 38 27 Total JUKEBOX queues are 100 This BP Queue processor was supporting the VI implementation serving SALT LAKE 4 6 2 17 Rescinded Watermarking Successful The following is an example of the email message generated when an image associated with a Rescinded Advance Directive is successfully watermarked with the text Rescinded Subj Import API Report 31292 06 22 11 08 14 8 lines From PROVIDER ONE basket Page 1 0 1 1 Image s Copied OK 0 Errors 1 MAGRSND 3110622 081451 3 2
161. l Naming Convention containing the server and share name for the remote storage location OPERATIONAL STATUS Logical state of the share or OFFLINE STORAGE TYPE GCC for Global Carbon Copy Displays as EXPORT HASH SUBDIRECTORY A flat or hierarchal folder structure will be created used default is hashed 48 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 3 7 15 Tab The Clinical Display software has the capability to display EKG strips from local and remote MUSE servers When a patient is selected the software maps to these MUSE locations using the NET USERNAME field 50 login in the IMAGING SITE PARAMETERS file 2006 1 and looks for the patient data When it finds the image data it is copied from the MUSE server to the Display station and viewed by the user To edit the properties of a network location right click the entry and select Properties on the pop up menu Note This popup menu can also be accessed from the keyboard by using Shift F10 RAD JUKEBOX Rovers GCC EKG URLs Diagrams NETWORKLOC EN OPERATIONAL USER NAME PAsSwonD MUSE MUSE VERSION Location Network Location Properties x 3 15 x vo 7 etre Field Description NETWORK LOCATION Name of a share on the MUSE server where the EKG data
162. l Status Status e On line READ WRITE access to this share e Off line no access to this share Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 Description Hash Subdirectory Setting e Yes Directory hashing is used Files are maintained in a 5 level deep subdirectory structure where directory will contain more than 100 unique filenames with their various extensions Both 8 3 and 14 3 format files are valid e No Image files are stored in the top level folder in a flat file structure which means that files are placed and retrieved from the root directory of the share Do not use this structure Share Availability Setting e On line Software can access shares on the network e Off line Software cannot access shares on the network Activities box Time Actual time when the IMAGE file 2005 was processed Activity Description of the action taken IEN IMAGE record number currently being processed File Filename in the current IMAGE file 2005 record being processed JB Full The DISK amp VOLUME WORM 82 2 value for the archive jukebox share in the IMAGE file 2005 and or IMAGE AUDIT file 2005 1 where Full image is located Other extensions will be listed here except the BIG file listed in the JB BIG column JB Big The BIG JUKEBOX PATH 103 value for the archive jukebox share in t
163. lanation Action Create Process failed ProgramName A system error occurred staring the process Log a Remedy ticket Increment queue name Ptr Failed The QUEUE POINTER 1 in the IMAGE BACKGROUND QUEUE POINTER file 2006 031 in VistA could not be updated On the main BP window use the Edit Refresh Queue Counts to correct the current counts Close the BP and restart the application Initialization Failure Log Files at C Program Files Vista Imaging BackprocLo g BackProc BPError log RAID groups not properly configured Use the Network Location Manager to reset your RAID groups Log file could not be created An active RAID Group has no online shares Check permissions on the log folder Make sure online RAID Group has online shares Requeue Failure trying to Requeue An attempt to re queue a failed queue entry failed Use the Queue Manager and step past the queue entry Determine the problem with the entry that would not re queue SetTime Handle Destin C Program Files Vista Imaging BackprocLo g BackProc BPError log Access is Denied Could not write the Access Date on the log file Check the file permissions on the log folder listed The Background Processor client software is version n n n n VistA Imaging Host system has version m installed Please update to compatible client and host software Shutting down the Background Processor The client software
164. le platforms MP4 A multimedia file containing encoded digital audio and video data based on the MPEG 4 part 14 standard The files can be streamed over the internet and can be accessed by numerous applications on multiple platforms MPG or MPEG media file based on one of several encoding methodologies created by the Moving Pictures Experts Group Some of the more common methodologies are MPEG 1 or MP3 used for audio data 2 used for broadcast quality television MPEG 4 or MP4 used for video computer graphics PAC An image file used in earlier versions of VistA imaging similar TGA file The file can normally be accessed through the VistA Imaging Clinical Display application PACS files are files imported through the DICOM Gateway and shown by the Clinical Display workstation PDF A document file containing document text images fonts and formatting information developed by Adobe Once the document has been created it will retain its format and style across multiple applications and platforms Numerous applications are available for viewing the file however a lesser number of applications are available for creating the file RTF A text file containing text and some formatting information developed by Microsoft The file can normally be accessed by most word processors or text editors on multiple platforms TGA An image file containing uncompressed or lossless compressed raster graphic
165. ltiple runs on the same day the highest sequence number is the latest log file run for the day as shown for the Scan2009_08_18_03 html file BP Verifier produces the following types of log files January 2012 Background Processor User Manual Rev 10 97 VistA Imaging MAG 3 0 121 5 7 1 1 Scan Log File The Scan log file lists entries with potential file integrity problems The log records the operational events that take place to correct a particular problem They are used to determine if and how the Verifier corrected the faulty condition The IENs that the Verifier could not fix are listed in the ScanError log file For the complete list of messages see Output HTML Messages Note No action is required on entries found in the Scan Log file Address c Program Filesvist Imaging BackProc log verifier Scan2009_08_16_01 html Date Time Message IMAGE_PTR FILE_NAME FULL_JB_PTR BIG_JB_PTR FULL VC PTR ABS VC PTR BIG VC PTR Current Write JB ALT 1 8 18 2009 9 4235 InitLogFile new logfile is crea PM ted CAProgram FilesiVistA lmaging BackP roc log werifienScan Log 8 18 2009 3 42 35 Range ALL PM 8 18 2008 Application EXE C Program 3 42 35 Files VistAlmaging BackP roc MagVerifier exe PM Application Version 30 1 39 15 8 18 2009 3 42 35 Application build date 07 1509 5 19 pm PM 8 18 2009 WS ID DOT VHAISWWHITEVM2 JOB ID 3 42 35 PM PID DE8 KIDS 3 0P39 8 18
166. messages listed in alphabetical order are generated or triggered by the Queue Processor Important Be sure to add the local Image support staff person to the local MAG SERVER mail group and at least one pager number in the MEMBERS REMOTE multiple 70 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 4 6 2 1 Ad_Hoc_Image_Site_Usage This message is sent when the menu option Ad hoc Enterprise Site Report MAG ENTERPRISE is used and it has completed gathering information Example Subj Ad Hoc Image Site Usage SALT LAKE CITY 660 31177 10 14 09 15 20 168 lines From IMAGPROVIDERONETWOSIX ONETWOSIX basket Page 1 SITE SALT LAKE CITY 660 Reporting Period Jul 06 2009 Oct 14 2009 DATE OCT 14 2009 15 20 48 EST DOMAIN IMGxxxxx MED VA GOV 2005 ENTRIES 17805 2006 81 ENTRIES 5 Production Account 0 WS DIS VERS 3 0 59 31 1 5 1 260071 WS DIS VERS 3 0 72 30 Win Server 5 2 3790 1 WS CAP VERS 3 0 72 30 Win XP 5 1 2600 1 4 6 2 2 Application Process Failure This message is sent by several of the Imaging applications when the PLACE value cannot be resolved for the image entry The PLACE value is a valid entry in the IMAGING SITE PARAMETERS file 2006 1 or a value in the ASSOCIATED INSTITUTION field 4 04 of this file Example Subj Application process failure 846445 23 Oct 200
167. n account Text file Patient ID not in VistA Could not locate patient ID in Contact IRM VistA TXT to BIG VC Copy TXT file to same share 5 None BIG file TXT to FULL VC Copy TXT file to same share 5 None FULL file Check Text Option Messages Text File Corruption Error Type 1 Text file is binary or unreadable Restore file from jukebox backup tapes Cannot determine Text file type Foreign text file was not likely generated on the image gateway Restore file from jukebox backup tapes Text File Corruption Error Type 2 Text file is ASCII but has unprintable characters or truncated Restore file from jukebox backup tapes Text Image DEN Mismatch Patient ID in text file does not match that in VistA Future utility patch Text Image SOP UID Mismatch The Series Instance UID in the text file does not match the one in VistA Future utility patch Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 Message Explanation Action Text Image Study UID The Study Instance UID in the Future utility patch Mismatch text file does not match the one in VistA Text Image UID Mismatch SOP and or Study UID are is Future utility patch blank in text file Updated Text file Text file has been edited Validate file has been copied to the jukebox No SSN Found Patient ID field missing in text file
168. ne how much free space is needed on the RAID shares for non interrupted processing of new images 2 Once that has been determined the Purge Parameters need to be set January 2012 Background Processor User Manual Rev 10 106 VistA Imaging MAG 3 0 121 3 specify which date the Purge parameters will use The Windows date options are e Modified e Created e Accessed 4 You should select the Express Purge option as this will minimize the time it takes to delete files from the RAID shares 5 You also select which shares or all are to be purged Purge Process 1 When the purge starts the application begins at the top of the directory tree on a selected RAID share and traverses to the bottom of the tree before starting on another share 2 When the purge finds a file that is a candidate for deletion based on the file date option selected it first checks to make sure the file is on the archive device jukebox and has the same file properties size etc e If the file exists on the archive then the file is deleted from the RAID share and its location pointer in VistA is cleared e If the file does not exist on the archive device the JUKEBOX entry is queued where the file will be copied to the jukebox The file is not deleted and no pointer in VistA is cleared 3 The purge application then moves onto the next file This process continues until all the selected RAID shares have been processed at which
169. network location 52 configuring 43 modifying properties 53 window 42 No AP entry Ptr 89 No AP Mult Ptr 89 No AP Ptr 89 No Image Ptr in AP 88 NoArchive log file 98 Not enough process memory 128 Not enough server cache 128 Not enough write cache available 128 0 operational status 44 45 46 48 49 50 51 93 Package 101 Package IEN 102 PACS UID 90 PACS UID field 60 90 PARENT DATA FILE file 2005 03 89 Partition queue 41 Password Windows 20 47 Patient ID 90 Patient Name 1 101 Patient Name 2 101 Percent Server Reserve 73 See Server Reserve Permissions EXPORT share 8 IMPORT share 8 READ WRITE on the domain acct 8 READ WRITE on the share folder file 8 Photo ID Action message 75 Photo IDs 30 48 55 60 75 113 Physical reference 44 45 46 48 49 50 51 92 93 PLACE value 71 pointer See Queue partition PREFET queue 12 60 Purge Auto 107 auto purge running 33 automatic 32 date criteria configuring 32 description 105 express 107 express settings 31 file types purged 107 manual 32 108 processing understanding 105 queues 40 result codes 108 results output 118 retention days configuring 30 retention times guidelines for setting 29 Scheduled 108 scheduled and express configuring 32 scheduled settings 31 scheduled running 33 setting parameters 106 settings 29 troubleshooting 138 W
170. nge that is rich with purge candidates this number will be rapidly reset to zero A continually growing IEN Count indicates that the Purge utility is in a range low in purge candidates During a manual purge the user may opt to stop the purge at that point The IEN Count is used in conjunction with the Express Purge Rate when Express Purge is active Purge Parameters Site File Prefix DM IE QRT Namespace and multi namespace names for the site Abstract keep days Purge parameter indicating the time frame for keeping abstract files on the RAID Full keep days Purge parameter indicating the time frame for keeping Full files on the RAID Big keep days Purge parameter indicating the time frame for keeping BIG files on the RAID Photo ID keep days Purge parameter indicating the time frame for keeping Photo ID files on the RAID Purge Criteria Date criterion used to determine which files to purge Options are Date Modified Date Created or Date Accessed Express Purge Express Purge Rate Indicates if the Express Purge feature was used in this purge The Express Purge will stop on a share when the IEN Count value reaches this threshold value Share Processing RAID share paths Location of shares being processed Abstract Full Image Big Text Photo ID Foreign Original File Counts Breakdown by file type of original files processed Note Legend on the right displays t
171. not be renamed It can only be deleted when all the tasks assigned to it are de assigned BP Server edits Logical Name ie BP1 Server Name iservername BB Add Cancel If the name is not valid error message is displayed You can correct the name repeat the steps 2 5 3 Assigning Tasks Queues to a BP Server By default no tasks are assigned to BP Servers The tasks will need to be assigned in order for that function of the BP software to operate You can assign tasks based on the needs of your facility As previously mentioned a queue name identifies the task that the Queue Processor performs All queues are available for you to assign to a BP Server except EVAL Note You should assign Purge as well as the Scheduled Verify to BP Servers These features help maintain the system without operator monitoring and control January 2012 Background Processor User Manual Rev 10 11 VistA Imaging MAG 3 0 121 1 Drag drop task from the Unassigned Tasks in the tree pane shown to the server that is designated to run that task Bu SALT LAKE CITY BP Server Parameters Imaging Site Parameters Mail Messages Mail BPT dj PURGE SCHEDULED VERIFY di ABSTRACT dj JUKEBOX JETOHD dj PREFET cj IMPORT 89 DELETE Background Processor Servers Unassigned Tasks Note The priority of tasks running on the same server is set internally and
172. ns VistA Imaging Shares RAID e ABSTRACT creates thumbnail files with the abs file extension when this file type does not exist for an image set These file derivatives only exist for certain types of files and can only be created when the Full or BIG files are present for an image set Queue types Import and VIC Photo ID will generate ABSTRACT queue ABSTRACT Queue VistA Capture Workstations and or the Import Queue add a request the ABSTRACT queue to create thumbnails ABS derivatives of images VistA Capture Workstations a 60 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 e IMPORT provides means for external applications to store images the VistA Imaging environment using the IMPORT APL It also watermarks images associated with a Rescinded Advance Directive with the text Rescinded IMPORT Queue External applications add a request to the IMPORT queue to capture external images typically clinical procedures Veteran ID Cards and iMed Consents in the VistA Imaging environment VistA Imaging Shares RAID e JUKEBOX copies images from a RAID share to a long term archive device jukebox JUKEBOX Queue When capture applications such as VistA Display Workstations acquire new images they add a requestto the JUKEBOX queue to copy these images from VistA Imaging shares to the Jukebox for long term archival storage Failed images are re queued for archival
173. on the text gateway A typical value is 25 Retention Days DICOM Messages Number of days to retain DICOM HL7 messages on the text gateway 30 days is recommended January 2012 Background Processor User Manual Rev 10 21 VistA Imaging MAG 3 0 121 3 3 Configuring Messages When the BP products are running they generate various alerts and informational messages These messages alerts are formatted into mail messages and can be sent to different levels of management within a facility The Mail Message subject lines describe the condition with the content of the message containing the specific information The recipients for each Mail Message Subject type can be set up using the Mail Message Manager 3 3 1 Messages Window The Edit gt Mail Messages menu on the Queue Processor menu bar opens the Mail Messages window used to set up recipients for each message type The tab Mail Messages can also be selected site Mail Message Manager Imaging Site Parameters Mail Messages Mail Groups Purge Verifier RG Settings BP Servers Queue Manager 9 Groups Vist Imaging Groups amp 9 Ad Hoc Image Site Usage H Q Application process failure RAID group purge Error MAG GB Auto RAID group purg GRP MAG GO GCC Copy Error GRP lt IMAGPROVIDERONETHREE ONETHREE Mem Get Next RAID Group failure INSTA
174. ou configure the MAGMIN parameter consider your site s Imaging network topology If your site s Imaging network has remote network locations then 15 minutes may be too low for the lapse time and should be adjusted accordingly Optional parameters are MAGFQ the variable for the sensitivity value for failed queues MAGMIN the variable for the sensitivity value for the time lapse between queue processing MAGEVAL the variable for the sensitivity value for EVAL queues Edit Option Schedule Option Name MAGQ BPMONITOR USER TO RUN TASK VARIABLE NAME VALUE 50 VARIABLE NAME MAGMIN VALUE 25 VARIABLE NAME MAGEVAL VALUE 50000 VARIABLE NAME VALUE VARIABLE NAME VALUE COMMAND Arrow down until you see the Command and then enter E for Exit answer YES to Save if you have made changes 74 Monitoring the BP Queue Processor The BP Server Utility handles all the entries that exist in the BP SERVER file 2006 8 and the BP queues assigned to each server Note The following procedures are not required They are suggested as efficient ways to monitor the BP Queue Processor as a preventative measure 7 41 Precautionary Guidelines D The BP Queue Processor should not be run under the following conditions e When network outages or VistA Hospital Information System outages occur January 2012 Background Processor User Manual Rev 10 125 VistA Imaging MAG 3 0 121 7 4
175. ow is displayed showing file values to help you debug the problem For details see section 4 6 3 3 IMPORT Queue Status Report 3 7 Network Location Manager The BP processor applications send receive images to from physical devices and networks using different types of media These types of media need to be recorded in the VistA database The information that is stored includes the type of media the location online status security access etc This information can be entered into VistA using the Network Location Manager Location AMC Network LocationManager_ PAID JUKEBOX Routers GCC EKG URLs Diagrams Se RG ATGI 5 RG ATG2 gt MAGIH MAG2H MAG3H a RG ATG3 MAG H MAGIH RG ATG4 MAG12H MAG13H HASH SUBDIR NETWORK LOC IEN PHYSI TOTAL SPACE FREE SPACE OPERATION READ ONLY STORAGE 28 WVHA 2362728 1427210 On Line YES MAGNETIC YES 4 List View Style New Add Group wv OK Cancel X Apply Help C List Report 42 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 3 7 1 Configuring the Network Location Manager The Edit gt Network Location Manager menu on the Queue Processor menu bar opens the Network Location Manager window Seven types of entries are
176. parison of the text files with VistA Note This is the preferred option as the procedure to correct inconsistencies is under development 92 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 5 Click the Start button to begin processing You will see processing activity in the GUI window Help Image Shares f JukeBox Shares NETWORK LOCATION PHYSICAL REFERENCE im UNTEN NETWORK LOCATION PHYSICAL REFERENCE OPERATIONAL STATUS HASH SUBE 8 DRKIN WHAISWWHITEVM1 DRKINGS Check Start Time 8 18 2009 3 47 49 PM 6 WORMOTG AVHAISWWHITEVMINMAGEJBT N On Line 76 DRKIN2 WHAISWWHITEWM1 DRKINGS ei Dont Check Run Time HisMinSec 0 059 27 W RMOTGH MVHAISWAWHITEVMTNIMAGEJBTSN On Line YES 37 862 NVHAISWWHITEVMTNGCC2SN 780 1 NVHAISWWHITEVMINMAGETSN Progress 793 NO Refs 21 90 AWHAISWWHITEVM1 IMAGE10 BadVC 18 73 MAGIA AWHAISWWHITEVM1 IMAGE21 Range BadJB 16 3 MAGIH AVHAISWWHITEVMI IMAGE1 Start Stop Refs 1 75 2 NVHAISVAWHITEVMTNMAGE23N rm E Sie Zaos 0 7 MAG2H AWHAJSWWHITEVMTNMAGE2SN Z Size Zero Deleted 0 4 Duplicates 4 JB Full JB Path 2 DM000793 DCM DM000792 DCM DM000791 DCM DM000789 DCM DM00078
177. play the image and the metadata DOC A text file containing data formatting instructions and possibly some image data created by Microsoft Word WordPerfect or WordStar applications The file can be accessed by various word processor or text editor applications on multiple platforms HTM or HTML A text file containing both data and Hyper Text Markup Language HTML which describes the structure of the data HTML is usually a set of tags which describe structural information such as text paragraph or document formatting information The file can be accessed through either numerous text editors or browser applications on multiple platforms When displayed through a browser the tag information will be used to format the data in the file 144 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 File Extension Description JPG or JPEG An image file containing a compressed bitmap of the image The degree of compression can be adjusted during file creation and is performed using algorithms developed by the Joint Photographic Experts Group This format is a standard image format that can be accessed by numerous applications on multiple platforms MP3 An audio file containing encoded digital audio data based on the MPEG 1 Audio Layer 3 standard The files will normally contain lossy compressed data and is a standard sound format that can be accessed by numerous applications on multip
178. py not ovenmritten 10 29 2009 12 30 55 PM JUKEBOX 294 10 29 2009 12 30 55 Server Reserve Low Water Mark 96 Free Space 17 98 10 20 2009 12 30 56 PM JukeBoxC acheSize JBCache Percent Space Available 98 10 29 2009 12 30 56 PM Jukebox 295 AVHAISWAVHIT EVM IMAGE M001 11D M00 1168 T GA WYHAISWVWWHITEVM1 IMAGEJB1 D M001 168 TGA 10 29 2009 12 30 56 PM Jukebox 295 Jukebox copy not ovenwritten 10 29 2009 12 30 56 PM JUKEBOX 295 AVHAISMAVHIT EVM 1 IMAGE 1 D 11D M001 168 TXT WYHAISWWHITEVM1 IMAGEJB1 DM001168 TXT 10 29 2009 12 30 56 PM JUKEBOX 295 TXT Not copied 10 29 2009 12 30 56 PM Jukebox 295 AVHAISMAVHIT EVM IMAG 110 001 168 5 W HAISWWHITEVMTIMAGEJBTPDMOO 1168 ABS 10 29 2009 12 30 56 Jukebox 295 Jukebox copy not ovenwritten Name Description Date Time Actual time when the IMAGE file 2005 was processed Event_Queue_Ref Queue name and entry number and status check info Message Path Description of action taken or statistics for status checks January 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 4 6 1 2 BP Error Log The BPError log file records error conditions with the operating system and Broker File Edit view Favorites
179. re in the DICOM DATA block lower section of the text file These fields are generated by the modality and should not be altered SOP Instance UID field DICOM 0008 0018 in the text file does not match the one in VistA node PACS UID field 60 in the IMAGE file 2005 Correction Most likely the text file has the correct UID Make the correction VistA PACS UID field 60 in the IMAGE file 2005 to match the DICOM field 0008 0018 e Study Instance UID field DICOM 0020 000D in the text file does not match the one in VistA node PACS UID field 60 on the PARENT Correction Most likely the text file has the correct UID Make the correction in VistA PACS UID field 60 in the IMAGE file 2005 to match the DICOM field 0020 000D SOP DICOM 0008 0018 and or Study Instance UID DICOM 0020 000D are is blank in the text file Correction If these fields are blank and the image is stored in VistA in TGA format then this crucial information is lost and it will be impossible to reconstitute the DICOM image Call the National Help Desk e Patient ID SSN in the top section DATA of the text file does not match the DICOM field 0010 0020 in the bottom section DICOM DATA Correction This file has already been corrected and needs no further correction if the Patients ID field SSN in the top section DATA 1 matches VistA January 2012 Background Processor User
180. retry AUTOLOGIN could not relog into the Broker Check for network connectivity Login Message Silent Login attempt failed AUTOLOGIN could not relog into the Broker Check for network connectivity Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 Message Explanation Action Make AbstractError abs is already present ABSTRACT file already exists at the RAID location specified in VistA None Make AbstractError filename MAKEABS the Mag MakeAbs exe could not create the abstract file Log a Remedy ticket NetConError Using User credentials WIN32 Error NetConError There is no password associated with this Network Location share name GCC Could not logon to the remote location with the Username Password in VistA GCC The password field is empty for this Network Location Correct the Username Password for the GCC location in VistA Enter a password for this GCC location No Image file entry was created IMPORT an IEN was not created in the image file Resend image from import source No Jukebox sourcefile available Attempting Abstract Queue JBTOHD There is no abstract file on the jukebox The abstract pointer in VistA is set The Queue Processor will attempt to make on from the Full or BIG file None No Tracking ID IMPORT failed No valid RAID share found IMPORT unique Tracking ID param
181. rge process is NOT configured The 4 Imaging cache servers will require operator intervention to ensure continued availability The following MAG SERVER members are being notified IMAGPROVIDERONETWOSIX ONETWOSIX IMAGPROVIDERONETHREETHREE ONETHREETHREE The next notifications will occur in 0 hours 4 6 2 7 Image File Size Variance This message is sent during a purge when a file on the RAID has met the criterion for deletion but the copy of this file on the jukebox is a different size Example Subj Image File Size Variance 852162 2 Dec 2009 16 28 45 0500 EST 6 lines From Image File Size Variance basket 1 New SITE IMGxxxx MED VA GOV DATE DEC 02 2009816 28 45 EST DOMAIN IMGXXXX MED VA GOV Filename False Positive CopySBY00012248164 TIF VistA Cache Size 14650 Jukebox Size 919190 January 2012 Background Processor User Manual Rev 10 73 VistA Imaging MAG 3 0 121 4 6 2 8 INSTALLATION This message is sent when the KIDS for this patch is installed Example Subj KIDS MAG 3 0 39 INSTALLATION 853149 10 Dec 2009 08 34 54 0500 EST 3 lines From INSTALLATION basket Page 1 New PACKAGE INSTALL SITE IMGxxxx MED VA GOV PACKAGE IMAGING VERSION 3 0 Start time Dec 10 2009 08 34 51 Completion time Dec 10 2009 08 34 54 Run t
182. rge will run at set intervals over all the RAID shares starting at a specified date time as specified on the Imaging Site Parameters window Note A BP Server must be assigned the PURGE task to run the Scheduled Purge e Manual User initiated Purge You can select one or more RAID shares The Purge Parameters and Express Purge options apply Note A BP Server does not have to be assigned the PURGE task to run a manual Purge 6 4 5 Purge Criteria The following table lists the result codes for the Purge Each file that is traversed is listed in either the Purge html or PurgeError html log file with its corresponding result code See the Reports section Purge html PurgeError html TGA ABS BIG extensions only Field Comments Action 3 Foreign file Not a valid file extension do not purge 2 Queued for jukebox copy do not purge 1 Do not purge 1 Purge given normal date criteria confirmed on jukebox 3 Purge if file is at alternate network location site else purge amp update RAID pointer 5 Purge if at alternate site queue jukebox if not on jukebox 0 no file 1 ABS 2 FULL 3 BIG 4 Photo ID January 2012 Background Processor User Manual Rev 10 109 VistA Imaging MAG 3 0 121 Status 1 No 2005 entry No Purge 6 Jukebox pointer set File on jukebox RAID pointer incorrect location Purge if image at other location 7 Jukebox pointer set File on jukebox No RAID pointer set Found file
183. rk Location defined using the Background Processor Queue Manager Referenced Image file pointers to the network locations of each of the file types network files stored within the VistA Imaging System Routers Specific type of Network Location defined using the Background Processor Queue Manager 154 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 Definition RPCs Acronym for Remote Procedure Calls RPC Broker Short name for the VA Kernel RPC Broker the Client Server interface component RPC Broker 1 1 is required for interfacing with the hospital database Site Parameters A set of specifications that is configurable to meet the individual needs of each VistA Imaging System implementation UNC Universal Naming Convention indicated by the format SERVER SHARENAME Verifier One of the three applications in the Background Processor used to validate the VistA Imaging network file references in the IMAGE file 2005 and to consolidate files on the jukebox See also Purge and Queue Processor Veterans Health VistA is built on a client server architecture which ties together Information workstations and personal computers with graphical user interfaces at System Veterans Health Administration VHA facilities as well as software Technology developed by local medical facility staff Architecture VIC Veteran ID card one o
184. rom the report Note The following integrity issues will not prevent their respective images from being displayed These are informational messages Message Generated Explanation No AP Ptr The IMAGE file 2005 record is missing the PARENT DATA FILE file 2005 03 for a Clinical Association Report AP This Image does not have the entry in the clinical application AP specified No AP entry Ptr This Image does not have the entry in the clinical application AP specified The IMAGE file 2005 record is missing the PARENT GLOBAL ROOT IEN for a Clinical Association Report AP 90 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 5 5 1 3 Text File Integrity When the Check option is selected in the Check Image Text window the Verifier compares specific fields in the text file with those in the associated IMAGE file 2005 record in VistA The following is a list of problems that the Verifier detects Included in the list is a suggested way of correcting these problems e Text file is binary or unreadable Correction Copy the version from the jukebox or get a copy from the backup tapes Text file is ASCII but has unprintable characters or truncated Correction Copy the version from the jukebox or get a copy from the backup tapes e Patients ID SSN field in the text file does not match that in VistA Correction Contact the National Help Desk The following fields a
185. rver using the Username Password contained in the properties of this storage type To edit the properties of a network location right click the entry and select Properties on the pop up menu Note This popup menu can also be accessed from the keyboard by using Shift F10 RAO JUKEBOX Rowers GCC Cache IDs Network Share Rosting Parameters 7 Swbdwectory 7 S Proposes EKG URLs Diagrams Location Network Location Properties Share Name br PKROUTEHASHED WHA VMS400 ROUTE Network Credentials User SVROUTETEST Password 7 Abstract Fui DICOM Roty os Conse 555 Max Retry on Transmit 7 Retention Days Operabonal Status Reed Routing Share Field Description NETWORK LOCATION Name of a share on the remote Radiologist s server Note Use a name that reflects the location where these images will be sent This name is used in the ROUTE DIC file on the Routing Gateway The record number VistA for this Network Location PHYSICAL REFERENCE The UNC Universal Naming Convention containing the server and share name for the remote storage location OPERATIONAL STATUS Logical state of the share or OFFLINE 46 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121
186. s are set properly The automatic purge will use these same Purge Parameters and if not set properly will result in unsatisfactory results As the volume of images increases from the gateways etc these parameters should be adjusted to compensate for the increase Scheduled purges typically are set up on a monthly basis but this will vary per site The goal is to keep the shares between 80 and 90 full Some adjustments in scheduling will need to be made after a scheduled purge cycle has completed Enabling Express Purge will greatly enhance the purging process by eliminating unnecessary file traversals that are not candidates for purging and thus significantly decrease the time to purge a share The Purge Factor is set to control when the purge on a share is terminated When the number of files that are traversed and not deleted has exceeded the number in the Purge Factor the purge stops on that share and begins purging the next share automatic mode 3 5 1 4 Configuring Purge Date Criteria Settings Purge Criteria Date Accessed Date Created Date Modified L Purge Criteria Date Accessed Date when the file image was last viewed on a VI workstation Date Created Date when the file was copied to the current disk share Date Modified Date when the file was last changed On the initial save the Date Created will be the same as the Date Modified Any of the three file date times can be used
187. s data developed by Truevision The file can be accessed through several paint applications on multiple platforms January 2012 Background Processor User Manual Rev 10 145 VistA Imaging MAG 3 0 121 File Extension Description TIF or TIFF An image file containing an uncompressed or lossless compressed bitmap of the image The degree of compression can be adjusted during file creation This format is a standard image format that can be accessed by numerous applications on multiple platforms TXT A text file containing data and very limited formatting instructions The file can be accessed by all text editors and word processors on multiple platforms WAV An audio file normally containing uncompressed waveform data The file is normally used with Windows based audio applications 146 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 January 2012 Background Processor User Manual Rev 10 147 VistA Imaging MAG 3 0 121 Appendix Verifier Integrity Samples A Text file is binary or unreadable 000000000000000000000000000000000000000000000000000000 LLIN Bees 000111222333444555666777888999 CDDDEEEFFFGGGHHHTITI3 J IKKKLLLMMMNNNOOOPPPQQORRRSSSTTTUUUVVVWHRDOOCYYYZZZ MAA JAA 7 tits 15555 mEEDDUZZZnnDDDD 5 mma aac 555 gt 1222 7 Und sis 99222 4222 900 ggg
188. s not match the in the IMAGE file 2005 January 2012 Background Processor User Manual Rev 10 89 VistA Imaging MAG 3 0 121 Message Generated Explanation Invalid Image Ptr to AP The Clinical Association Report AP has image references that are not in the IMAGE file 2005 Conflicting GP and GO DEN The patient file reference DEN in the Group Parent GP is not the same as the DEN in the Image entry GP amp GO AP Mismatch The Group Parent and Group Object pointer references to a Clinical Association Report AP do not match GP Missing GO Ptr The Group Object multiple of the referenced Group Parent does not reference this group object No AP Mult Ptr This Image entry does not have the clinical application AP image multiple entry number specified The IMAGE file 2005 record is missing the PARENT DATA FILE IMAGE POINTER for a Clinical Association Report AP GO DEN mismatches Some image file Group Objects have different PATIENT file 2 references DEN Image entry is structurally The normal structure that distinguishes Image entry Group abnormal Parents GP Group Objects GO and Non Group image NG is corrupt Missing Group Objects The Group Parent has Group Object references that are missing DFN Mismatches in AP Image The Clinical Association Report AP references a Group Mult Parent that has image files with a PATIENT file 2 reference DFN that is different f
189. se a locally defined routine January 2012 Background Processor User Manual Rev 10 55 VistA Imaging MAG 3 0 121 56 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 Chapter 4 Queue Processor 4 1 Application Description Setting up Tasking Understanding Processing Starting Running the application Reports Application Description The Queue Processor application is the main application in the BP product suite It processes all the I O operations between the RAID shares and the archive device jukebox It is important that this process be monitored daily and kept running continuously It performs the following tasks 4 2 Copies new images from the RAID to the jukebox Retrieves images from archive storage to the RAID Triggers Purge events automatic and scheduled Triggers Verifier events scheduled Manages disk space consumption specified by the Imaging Coordinator Processes queue entries Creates abstract files from Full BIG files Processes images from remote cameras and capture device in Clinical procedures Copies images to remote destinations outside of Imaging Watermarks images associated with a Rescinded Advance Directive with the text Rescinded Setup Guidelines Once the Queue Processor is installed one or more BP Servers are required for processing Tasks are assigned to each BP Server One task cannot be assigned to multiple servers however a
190. sor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 e EVAL entries are initiated by the DICOM Gateways to facilitate auto routing of images to remote display workstations Note The EVAL queue is not processed by the BP Queue Processor but may be purged using the Queue Management by Type option 4 4 EVAL Queue Stage 1 A site can set up routing rules that determine if an image meets certain criteria for exporting to external locations ex to route CT scans to a particular physician If a DICOM Gateway is configured as part of a routing environment as it accepts images from modalities the DICOM Gateway adds a request to the EVAL queue to evaluate an image to see if it is a candidate for routing The image is then routed to a remote VistARad workstation for the physician to view remote VistARad pros 8 m Queue 8 WU Stage 2 If there are no active routing processors requests entries in the EVAL queue can grow to a large number of entries To resolve this the Queue Manager can be used to periodically purge the requests In addition the gateway parameters must be changed to turn off Auto Routing See the Image DICOM Gateway User Manual Accumulating Requests Queue Manager X Understanding Processing When the BP Server tasks are set up and the parameters are set to the values determined by the site you click the Start button to start processing queue task entries The processing steps for a typical
191. stA database that contains entries of images IMAGE AUDIT File in the VistA database that keeps a record of any image entries file that were deleted or missing Also used by the Verifier to ensure that a file set exists at the location s specified Image Set Includes the FULL ABS TXT files and possibly the BIG file Imaging server Server used to store the most recently acquired and accessed image files Internal Entry Unique record number for a specific entry in a FileMan file Number Depending on the context IENs can serve as identifiers for an image set a single site or other unique records in files in the VistA database IRM Acronym for Information Resources Management the Imaging support staff at a VA hospital January 2012 Background Processor User Manual Rev 10 153 VistA Imaging MAG 3 0 121 Term Definition Jukebox Long term storage device in VistA that holds multiple optical discs or platters and can load and unload them as needed Also called Archive Magnetic cache Same term as RAID See RAID Namespace First three characters of the 14 character name given to image files captured at a site Each VHA facility has its own unique 3 character namespace Offline VistA Imaging shares designation used to isolate shares from auto write candidacy and the purge function Online PACS Purge Connected to served by or available through a system and especially a
192. tart Time Date Time this Verifier scan was started Run Time Total elapsed time the Verifier ran Total IENs Number of image file entries processed in this scan No Refs Number records with no RAID or archive device jukebox location references Bad VC Refs The number of IMAGE file 2005 entries with Image share references that could not be matched to an actual file stored on an image share Bad JB Refs The number of IMAGE file 2005 entries with jukebox references that could not be matched to an actual file stored on a jukebox Alt JB Refs The number of files found on multiple jukebox share locations is listed These are copied to the current jukebox share using the aggregate function Size Zeros The number of zero length files found on the Image shares and archive jukebox shares Size Zero Deleted Number of files deleted that had a size of zero Only image share files will be deleted Duplicates Number of Image entries that are duplicated in the IMAGE file 2005 and the IMAGE AUDIT file 2005 1 These images are not viewable because the image files themselves have the same file names and therefore have ambiguous patient and procedure references Jukebox Shares box Entry number in the NETWORK LOCATION file 2005 2 Network Location Name The name of the entry in the NETWORK LOCATION file 2005 2 Physical Reference Network path of this Network Location entry Operationa
193. te the file creation the Verifier will clean up the database pointers For example when capture events time out prior to the file being copied to the RAID they are automatically deleted by the capture application this results in an NO ARCHIEVE event The image entry will be in the IMAGE ARCHIVE 2005 1 file with no reason for deletion References are set in patient reports for the images in order to support archiving and viewing Occasionally images on a report belong to another patient The Verifier will detect these inconsistencies and report them Files are removed from the RAID to free up storage space and files are recalled from the jukebox when they need to be viewed Pointers are reset set for each of these studies 100 s of images The Verifier will detect and possibly repair any inconsistencies Resolve inconsistencies in the database that can result because of discrepancies between files that interact manual corrections network anomalies power outages hardware failures and incomplete database updates Maintenance Operations Verifier scans can be run any time of the day as there is minimal impact on VistA They should be run based on the following events 88 Routine scanning of newly acquired images The Verifier should be run every 1 or 2 weeks to verify new entries in the IMAGE file 2005 In some cases if images missing they can be resent from the modality e Periodic maintenance of the VistA Imaging s
194. ted C Program Files VistA lmaging BackProc log purge Purge Log 8 18 2009 3 18 40 em NOT PURGEDWVHAISWAQYWHIT EVMTUIMAGE 1 C HADWOW0W 11144C HADODOO011435 ABS Purge Criteria 3 0 10 PM 43 2009 8 18 2009 3 18 40 NOT PURGEDYVHAISWAWHITEVM IMAGE 1 SCHADYOYOY 11120 HADOO0001 1435 D C M Purge Criteria 3 0 10 PM 4 3 2009 8 18 2009 3 18 41 T NOT PURGEDWVHAISWAVHIT EVMTUIMAGE 1 CHADWOWNW 111 44C HAOOOO001 1435 TXT Purge Criteria 3 0 10 PM 43 2009 8 18 2009 3 18 41 NOT PURGEDWVHAISWAQTWHIT EVM IMAGE 1 3C HADDOYDOSO 111 44C HAD000001 1436 ABS Purge Criteria 320 10 PM 4 3 2009 8 18 2009 3 18 41 adr NOT PURGEDWVHAISWWHIT EVM IMAGE 1 CHADWOW0W 11141C HAOOO0001 1436 D CM Purge Criteria 3 0 10 PM 4 8 2008 8 18 2009 3 18 41 m NOT PURGEDWVHAISWAQYVHITEVMTUMAGE 1 3CHAOVOYDOSD 11144 HADO00001 1436 TXT Purge Criteria 32 0 10 PM 4 8 2009 8 18 2009 3 18 41 NOT PURGEDWVHAISWWHITEVM1IMAGE1 C HADWOWNW 1114 0 1 1437 ABS Purge Criteria 3 0 10 PM 48 2009 8 18 2009 3 18 41 PURGEDWVHAISWAQTWHIT EVIMTUIMAGE T SCHAOVDOVOYO 111 4C HADOOOO0 1 1437 DCM Purge Criteria 320 10 PM 4 8 2009 8 18 2009 3 18 41 TN NOT PURGEDWVHAISWWHIT EVM IMAGE 1 CHADWOWOW 111237 HAD000001 1437 TXT urge Criteria 3 0 10 PM 43 2009 8 18 2009 3 18 41 idu NOT PURGEDWVHAISWWHIT EVM IMAGE 1 CHADWOWNW 1114 C HAOO00001 1438 ABS Purge Criteria 3 0 10 PM 43 2009 8 18 2009 3 18 41 PURGEDWVHAISWWHIT EVM IMAGE 1
195. tered into the following fields in the IMAGING SITE PARAMETERS file 2006 1 They are the Service account Access Verify codes o DICOM GATEWAY ACCESS CODE field 124 o DICOM GATEWAY VERIFY CODE field 125 2 3 2 1 Security Keys in VistA Both the primary and Service accounts should have the security access listed 2 4 MAG SYSTEM as a security key MAG WINDOWS as a Secondary Menu Option Installation Follow the information contained in the Patch Description document for installing both the KIDS and the client software Both of these installations are mandatory for operating the BP software 2 5 2 5 1 Configuring BP Servers Guidelines It is necessary to configure a BP Server only if the site is capturing images for storage on VistA Imaging servers At least one BP Server must be present to perform utility functions such as copying image files to and from Imaging servers the RAID shares and the archive a jukebox The software does not permit redundant assignments of BP activities For example you cannot specify that more than one BP Server perform the JUKEBOX task The JUKEBOX and DELETE tasks should run on the same server If not the Deletes may be processed in advance of their being written to the Jukebox and the Delete will eventually fail These Failed Deletes must be Re Queued The IMPORT and ABSTRACT tasks must run on the same server There will be occasional archived FULL files that do not have abstracts
196. tes Help My Computer HKEY_CLASSES_ROOT Name Type ab Default REG 52 eel etre Washington 9200 REG_SZ ab Baltimore 9200 REG_SZ Gq HARDWARE ab Baltimore _ Servers gt E in My ComputerHKEY LOCAL MACHINESSOFTWARESvistaNbrokerSServers Close the Registry Editor If the server name is not resolved through DNS open the HOSTS file located in either WINNT system32 drivers etc WINDOWS system32 drivers etc Add a line to the file that includes the IP address and name of the remote site s Broker server HOSTS 10 2 1 1 Washington 10 2 1 2 Baltimore END January 2012 Background Processor User Manual Rev 10 142 VistA Imaging MAG 3 0 121 10 Save and close the HOSTS file 11 If you set up servers to connect to a server that can be resolved automatically through domain name server DNS e g alpha3 yourva gov no entries are needed in the server s HOSTS file 12 Reboot the server and run the Kernel Broker test program RPCTest exe is a test program distributed and installed on your PC in the C Program Files VISTA BROKER folder when the Kernel Broker Client Agent software is installed When executed it can be used to test the connection to the VistA System This is valuable in troubleshooting problems with the VistA Imaging System Please review the Kernel Broker documentation for more information and examples on the test application January 2012 Background Proc
197. the designated time Example SITE SALT LAKE MED VA GOV DATE Feb 11 2010 00 30 04 PST The SALT LAKE HCS implementation of VistA Imaging has failed to start the schedule Verifier activity The task is currently assigned to BP Server VHASLCBP1 4 6 2 14 Site Report Task Was Restarted This message is sent by the Monitor Background Processor Activity MAGQ BPMONITOR menu option if the monthly Imaging Site Usage report has to be re tasked Example Subj Site report task was restarted 31231 10 27 09 07 13 4 lines From VistA Imaging MAGQCBP basket Page 1 New SITE IMGxxxx MED VA GOV DATE Oct 27 2009807 13 01 EST The inactive monthly Imaging Site Usage report task was restarted The problem was Inactive 4 6 2 15 BP Eval Queue This message is sent when number of entries on the EVAL queue exceeds a user defined threshold Example SITE SALT LAKE MED VA GOV DATE Mar 30 2010 13 25 EDT The total number of EVAL queues is 9451 Please review the DICOM Gateways to ensure Routing is appropriately setup with the correct destination If your site is not using DICOM Gateway for Routing then review the Imaging DICOM Gateway Installation Guide Section 4 3 On Demand Routing will not generate EVAL queues if your site is doing only On Demand Routing then the DICOM Gateway parameters are set incorrectly Chec
198. the images and title Number of Queues Total number of files that will be copied Number of ABSTRACT Number of abstract files that will be copied Number of BIG Number of BIG files that will be copied January 2012 Background Processor User Manual Rev 10 79 VistA Imaging MAG 3 0 121 Description Number of FULL Number of Full files that will be copied Patient List of patients for the requested images and their patient ID 4 6 3 3 IMPORT Queue Status Report The IMPORT Queue Status window displays queue parameter and log information for IMPORT queue entries processed or unprocessed When the entry has not been processed the window will display the data in the queue entry in VistA and also the parameters that will be used in extracting the data from the remote location More information will be displayed after the IMPORT queue entry has processed The window will show the progressive steps of the queue entry processing It will also show any errors that occur The field descriptions are described below 80 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 Select View gt Import Queue from the main menu bar to view this window Windows Session Tab displayed Import Queue Status Tracking ID Looku Import Queue Looku CP 3 3030123 16381 Acquisition Session file 2006 041 Import Queue File 2006 034
199. tion Description au oe ee ciel a a dio patet te ea susce 106 6 2 3SeL Ung LE Ae 106 6 3 Sus Bw te 106 6 4 Understanding Processing se eco OD ae aS SPA RUSSIA IS 106 6 4 1 Setting Purge Parameters cx 107 6 42 File TSpOS FOr PULZ renean s udi Mie N 108 6 4 3 Purge Dates e Vete 108 PUES OpHONS uu cre a eed ere E 108 6 4 3 Criteria ac Ga Sls udi 109 6 5 Starting Running the Purge scorso o eoa o viro bs 110 60 IR 9 4 115 6 6 1 Log 252 115 1 1 Prurse Log Ee us 116 6 0 L2 IB rseBiror Log Piles gae adda a doi ie eee 117 6 6 2 Bmalls 118 6 6 2 1 Scheduled Purge Failure 55 118 6 6 5 Screen Generated Output 119 6 6 31 Purge Results 119 Chapter System 122 7 1 Description of the BP Server Monitor 11
200. tiple runs on the same day the highest sequence number 15 the latest log file run for the day The Purge run produces two types of log files shown Purge date html and PurgeError date html January 2012 Background Processor User Manual Rev 10 115 VistA Imaging MAG 3 0 121 6 6 1 1 Purge Log File The Purge html log file records the current share being purged as well as all of the successful deletions and the reason they were deleted The following example shows a copy of the purge results 116 C Program FileslvistAYImaginglBackProcllogipurgelPurge2009 08 18 html Date Time Event Type Message 8 18 2009 3 18 39 Begin Purging Share WVHAISWWHITEVMTUIMAGET1 8 18 2008 3 20 46 PM Purge Criteria 321 6 WVHAISVAVHITEVMTUIMAGETPDNMYDODS53DMOO0592 ABS 4 8 2009 8 18 2008 3 20 46 PM Purge Criteria 3 2 6 WVHAISWWHITEVMTUIMAGETPYUMNOOYDS3DMOO0582 TIF 4 8 2008 8 18 2008 3 20 46 PM AltLastFile WVHAISWWHITEVMTIMAGET1 DMYOY53DMOO0582 TXT 4 8 2009 8 18 2008 3 20 46 PM Purge Criteria 321 6 WVHAISWAWHIT EVM IMAGE TPDNMYODS3DMOO0593 ABS 4 8 2009 8 18 2009 3 20 46 PM Purge Criteria 3 2 6 WVHAISWWVHITEVMTIMAGETPDNMYDOUDS3DMOOO0593 TIF 4 3 2009 8 18 2009 3 20 46 AltLastFile WVHAISWWHITEVMTIMAGET1 UNMYDOYS53DMOO0583 TXT 4 8 2009 8 18 2008 3 20 46 Purge Criteria 321 6 WVHAISVAVHITEVMTUIMAGETPDNMYDQ5DMOO0595 ABS 4 8 2009 8 18 2009 3 20 4
201. ttrrtt 771171 111090 s d ANMAAARAAAAAAAAAAAEESCCCEEEEEEEEEEEEIII I I 777 S AAA OG DUDU fifi o 660800668606 eee b yyybbbyyy 000000000000000000000000 00000000000000000000 00000000000000000000000000000000000000000 000000000000 0000000000000000000000000000000000000 00000000000 0 0000000000 0000000000000 000000000000000 000000000000000000000 5 4 00000000000000000 0 0000000000000 00000000000 0000000000000000000000000 amp amp 00000000000000 OOO0000000 000000000 000 00000000000 000000000000000000000000000 0000 amp 32 amp 0000000000000000000000000 0000000000000000000 000000000 000000000000000000000000000000 amp 021 00000 000000000000000000000 00000000000000000000 00000000000000 00 0 Text Text is ASCII but has unprintable characters or is truncated BEGIN DATA PATIENTS _ 12348 PATIENTS_ID 000 81 8251 PATIENTS_BIRTH_DATE 1921 PATIENTS_AGE 81 PATIENTS_SEX M IMAGE_DATE 05 1 0 2001 IMAGE_TIME 1 4 47 40 END DATA1 BEGIN DICOM DATA END DICOM DATA Text file C Patients ID SSN field in the text file does not match that in VistA o for this sample is 1800 BEGIN DATA1 PATIENTS I ED00 66 5698 gt PATIENTS BIRTH DATE DKC 12 1942 PATIENTS AGE 59 PATIENTS SEX M Text file 2005 1
202. uary 2012 VistA Imaging MAG 3 0 121 GO Vista Storage 7 10 58 AM Current Write Location MAG1H Refresh Current Write Group Refresh All RAID Shares O MAGIH 2 145 The VistA Storage area on the Queue Processor GUI can be refreshed with the most current storage utilization statistics for RAID Groups and RAID shares by clicking the buttons Refresh Current Write Group or Refresh All RAID Shares 4 6 3 2 JBTOHD Report When you select View gt JBTOHD Report from the menu bar the following graphic is displayed This window displays a summary of all the entries in the JBTOHD queue and the file types that will be retrieved for all the entries You can save this report to the disk with the File menu The fields in this window are described below Select View gt JBTOHD Report from the main menu bar to view this window Number of Queues 34 Number of BIG 7 Number of FULL 14 Number of ABSTRACT 13 JBTOHD Report 9 29 49 AM Currently Active Jukebox to Harddisk Queues P Ea Image Queuer BACKGROUND USER IMAGING COORDINATOR MEDICINE Patient PATIENT EIGHTSIXZERO 1040 Patient PATIENT NINETWOEIGHT 8 Patient PATIENT ONEZEROZEROSEVEN 1103 Patient PATIENT ONEZEROONEONE 1036 Name Description Current JBTOHD queue Number of entries in the JBTOHD queue and the request date time Image Queuer User who requested
203. uary 2012 Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 137 138 Message Explanation Action GP amp GO AP Mismatch The Group Parent and Group Object pointer references to a Clinical Association Report AP do not match Future utility patch GP Missing GO Ptr The Group Object multiple of the referenced Group Parent does not reference this group object Future utility patch No AP Mult Ptr This Image entry does not have the clinical application AP image multiple entry number specified The IMAGE file 2005 record is missing the PARENT DATA FILE IMAGE POINTER 17 for a Clinical Association Report AP Future utility patch GO DEN mismatches Some image file Group Objects have different PATIENT references DFN Future utility patch Image entry is structurally abnormal The normal structure that distinguishes Image entry Group Parents GP Group Objects GO and Non Group image NG is corrupt Future utility patch Missing Group Objects The Group Parent has Group Object references that are missing Future utility patch DEN Mismatches in AP Image Mult The Clinical Association Report AP references a Group Parent that has image files with a different PATIENT reference DEN than the report Future utility patch Background Processor User Manual Rev 10 VistA Imaging MAG 3 0 121 January 2012 8 3 3 2
204. ull and BIG files Recommendation VistA Imaging Cache or RAID share devices operate more efficiently when 10 percent of disk capacity is available Some degradation occurs as the storage devices fill and files become fragmented The system is designed to notify the VistA Imaging system manager and the ADPAC when VistA Imaging shares resources have reached a critical level default is 5 free space remaining This value is too low for normal workflow At this point the Automatic Write Location update option no longer operates 6 4 2 File Types for Purge By default the file extensions except TXT in Appendix B are automatically purged from the RAID shares In order to have the TXT files purged an entry must be made for TXT in the File Types field on the Imaging Site Parameters window on the Queue Processor application this is set up by the installation 6 4 3 Purge by Dates The Purge uses the following Windows file dates Every file in Windows has these dates set Date Created Date Accessed Date Modified Recommendation Use the Date Modified for most cases 6 4 4 Purge Options Express Purge This option can be used for any of the three types of Purges described below The algorithm is based on the principle that most files that are deleted during a purge are older files The newer files remain on the share as they are within the keep dates for the Purge Parameters The time it takes to traverse through these newer
205. un daily using the Kernel Scheduling menu option in the following example 7 3 2 1 1 VistA use the Schedule Unschedule option KUTM SCHEDULE to task the activity Add the MAGQ BPMONITOR Set the date and time to run the monitor the first time Set the Rescheduled for example 6005 for 10 minutes If the time is set for 10 minutes then the job will execute every 10 minutes The S must be capitalized Example Select Taskman Management Option Schedule Unschedule Options Example Select OPTION to schedule or reschedule MAGQ BPMONITOR Monitor Background Processor Activity Are you adding MAGQ BPMONITOR as a new OPTION SCHEDULING the 39TH No Yes Option Name MAGQ BPMONITOR Menu Text Monitor Background Processor Act TASK ID QUEUED TO RUN AT WHAT TIME 20 2009 24 00 DEVICE FOR QUEUED JOB OUTPUT QUEUED TO RUN ON VOLUME SET RESCHEDULING FREQUENCY 600S TASK PARAMETERS SPECIAL QUEUEING If this field is blank then the job will run only once 124 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 7 3 2 2 Example 2 The following example is obtained by entering NEXT at the COMMAND prompt Arrow down to the bottom to see the COMMAND prompt This example uses the parameters mentioned in section 7 2 Configuring the BP Server Monitor to configure the utility to meet the needs at your site Important When y
206. up dialogue for the local mail group 3 4 1 3 Adding Members to Mail Groups 1 From the Queue Processor menu bar select Edit gt Mail Messages to open the Mail Groups window or select the Mail Messages tab 2 Drag drop selected VistA users from the right list boxes to the Mail Groups list box VistA will automatically be updated to reflect the change January 2012 Background Processor User Manual Rev 10 25 VistA Imaging MAG 3 0 121 3 414 Adding Remote Members to Groups 1 Right click a mail group and select Add Remote Mail Member from the popup menu displayed Note This popup menu can also be accessed from the keyboard by using Shift F10 Mail Messages 1 Mail Groups Mail Groups Main Site Parameters Add Remote Mail Member 2 MAG GB Delete Group Member MAG GB Phc Properties MAG GB 2 MAG GB Processo 1 59 19 2 Inthe Adding Remote Member dialog box displayed type the following email username or phone number followed by the sign followed by the domain The system uses SMTP Protocol Adding Remote Member MAG GB Imaging Site Verific email id verizon net for remote email or EXAMPLES 333 333 9990 44 att net for a text message system 3 Click OK 3 4 1 5 Deleting Members from Mail Groups When a user or group of users no longer wishes to receiv
207. v 10 January 2012 VistA Imaging MAG 3 0 121 3 2 1 1 Administrative Settings Administrative Current Namespace 50 RAID Write Location H gt Generic Carbon GCC gt Current RAID Group 86 501 Import Queue Security Site Code 51 Associated Institutions Vist amp Rad Grouping iste namel DOM fregion Field or Checkbox Description Current Namespace Each VHA facility has its own unique 3 character designator The Current Namespace file is used to store this 3 letter facility designator It is used in Imaging as the first 3 characters of the 14 character name given to image files captured at this site The VistA Imaging development and support teams maintain a central database with each sites 3 letter designator The Current Namespace field is not configurable This is necessary to ensure that image file names across VHA are unique RAID Write Location All images from the gateways Capture etc will be written to this share The selected Current RAID Group determines which shares are listed on this dropdown list Generic Carbon Copy Remote share where files will be exported The share permissions must match the login credentials for the BP Server Current RAID Group The current active RAID Group includes the RAID Write Location described above When new images are processed they are stored on the RAID Write Location share within this group The RAID Groups are set up
208. y 2012 Background Processor User Manual Rev 10 1 VistA Imaging MAG 3 0 121 12 VistA Imaging and the Background Processor The diagram below shows a network configuration of the VistA Imaging system The system requires a minimum bandwidth of 100MB sec Typically the Clinical workstations and EKG systems are on this span The VistARad workstations RAID and archive device are required to reside on a span that has a 1GB sec bandwidth This high bandwidth results in faster viewing times for studies on those VistARad workstations VistA Imaging Network Topology Main VistA HIS Clinical Display Workstations Clinical Capture Workstations Fast Ethernet Imaging File Servers Short Term Long Term Storage Archive Main hospital backbone Gigabit Ethernet Jukebox CRIDR DICOM compliant Acquisition Modalities 2 Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 13 Imaging Functional Flow The diagram below shows the functional flow of the VistA Imaging system related to the Background Processor products Images originate from a variety of sources and are stored for the short term on the RAID The Background Processor s Queue Processor copies these images to the long term archive device where they are stored permanently The Background Processor s Purge application manages free space on the RAID by deleting older images The Queue Processor
209. ystem The Verifier should be run once a year to verify the entire range of Image Internal Entry Number IENs in the IMAGE file 2005 During the year many files will be retrieved from the jukebox and pointers updated in the database Allowing the Scheduled Verifier to run on a regular basis will insure that files on the RAID and the Jukebox can be accurately located Background Processor User Manual Rev 10 January 2012 VistA Imaging MAG 3 0 121 Large Image Share population events There may be occasions where files were not copied and incorrect file pointers set in the database with this large volume of files being moved to the RAID Running the Verifier over the range of Image IENs that were copied back to the Image shares from the jukebox will insure correct pointers e Image share or Jukebox outages The Verifier should be run after the resolution of any event that interrupted the flow of images to the Jukebox The Queue Processor will attempt to copy files to the jukebox 3 times At that point it will indicate failure and begin processing the next entry in the queue Note that these files ONLY reside on the Image shares and therefore MUST be copied promptly to the jukebox using the Verifier 5 5 1 Integrity Checks The Verifier steps through each of the IENs within the range looking for specific types of problems The following sections describe the integrity checks performed on these files 5 5 1 1 File Integrity File locat

VistA Imaging System Background Processor User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents