Vista Imaging Vista Routing manual How Load Balancing Works, Resetting the Load Balancing Counter

Page 21

Routing User Guide

Defining Routing Rules

 

 

How Load Balancing Works

When a rule incorporates the balance command, the routing software uses two things to determine which destination receives a given exam: the percentages specified in the rule and internal counters set by the routing software.

When a rule including a balance command is first applied, the routing software begins distributing exams the same way a deck of cards is dealt: the first destination receives one exam, the second destination receives the next exam, and so on. Exams are evenly distributed until the destination with the lowest value specified in the balance command has received its allotted percentage of exams. Then that destination is skipped until the counter resets. Since load balancing is based on percentages, the counter is reset each time 100 exams have been sent.

For example, if a rule specifies…

balance("DEST1"=10%,"DEST2"=40%,"DEST3"=50%)

when MODALITY="CR"

ƒThe first 30 CR exams will be distributed evenly, with each destination receiving 10 exams. Once DEST1 has received 10% of the exams, the routing software will skip DEST1 until the counter resets.

ƒThe next 60 CR exams are split evenly between DEST2 and DEST3. After this point, DEST2 and DEST3 each have a total of 40 exams. DEST2 now has its allotment of 40 exams, and will be skipped until the counter resets.

ƒThe remaining 10 CR exams are sent to DEST3, giving that destination a total of 50 exams.

ƒOnce 100 CR exams have been sent, the routing software resets its counters to zero, and starts distributing exams to all three destinations again.

Note that a destination receiving a comparatively smaller percentage of exams will become idle more often than destinations that receive a greater percentage of exams.

Resetting the Load Balancing Counter

When routing rules are imported, the counters used for load balancing are all reset to zero. You can take advantage of this trait if you need to fine-tune or troubleshoot situations where load balancing is used. Note that it is not necessary to change routing rules to achieve this; you only need to re-import them.

April 2006

VistA Imaging V. 3.0, Patch 18

13

Image 21 Contents
Routing User Guide-DRAFT April VistA Imaging V .0, Patch Contents Troubleshooting Routing Terms of Use IntroductionAbout this Manual Using this ManualConventions AcknowledgementsRelated Documents Revision TableDate Rev This page is intentionally blank Routing Explained Routing OverviewWhat is a Routing Gateway? Routing PrerequisitesInfrastructure Requirements Operational Requirements Identifying Images to be Autorouted How Autorouting WorksSending Images to Destinations Autorouting Images from Prior ExamsDeletion of Routed Images Remote Reading with VistARadRouting Overview Selecting Images for On-Demand Routing How On-Demand Routing WorksPriority and Autorouting How Routing Priority WorksPriority and On-demand Routing Other Priority FactorsDefining Routing Rules Routing Rules ExplainedHow Routing Rules Work Rules using Multiple Conditions Sample Routing Rules Simple Routing Rule Rules using Wildcards Rules using the does not match OperatorRules using Date/Time Conditions Send Command Balance CommandRule Destinations How Load Balancing Works Resetting the Load Balancing CounterRule Conditions PropertiesFrequently Used Properties NOW Other Properties Network storage location of the image abstractPath for the network location of the stored image Unique 26-character image identifier of the Pacs image Name of the Radiology Report associated with the image Operators ValuesOperator Image property must… Values for Date/Time Properties Send CR images to Kansas on Mon/Wed/FriSend CR images to Kansas on Holidays Routing Images from Prior Exams Routing Rule PriorityPrioritize images based on destination Do or Do Not include Prior StudiesRouting Rule Tips This page is intentionally blank Configuration Task Performed By Configuring RoutingDefining Imaging Destinations Naming Conventions for Imaging DestinationsField Description Storage Location Names for offsite MRI specialist Network Location File Entries at JonesvilleStorage Folders for Imaging Destinations Folder PrerequisitesFolder Creation Folder Verification Testing folders from the sending site ExplorerTesting folders from the sending site Command Line Imaging Destination Definition using FileMan Imaging Destination DefinitionEditing the Network Location File at the sending site Imaging Destination Values Physical Reference Do not use This field is not used for routing, and should be left blank Retention Period Naming Conventions for Dicom Destinations Defining Dicom DestinationsDicom Destination Definitions in SCUList.dic Adding Dicom Destinations to SCUList.dicMagdmenu Field Definitions Defining Route Priors Logic Verifying that Prefetch is EnabledHow Prior Exam Routing Works Altering Route Priors LogicSelect the following fields for editing To change route priors logicDicom Gateway Configuration Image Gateway ConfigurationTo configure Image Gateways To configure the Routing Gateway Routing Gateway ConfigurationImporting Routing Rules Route.dic Creating and Importing a Routing Rules FileTo create and import routing rules To verify imported rules Verifying Imported RulesRouting Rules & Multiple Routing Gateways Re-Importing Routing RulesTo set routing-related VistARad site parameters VistARad Configuration-Sending SitesTo set the CacheLocationID in MAGJ.INI VistARad Configuration-Receiving SitesMaking Multiple Destinations Accessible to VistARad Routing System Change Related Configuration Change Changes Affecting Routing System ConfigurationUsing the Routing Gateway Activating RoutingStarting the Evaluation Processor Starting the Transmission Processor Using Routing Log Files Periodic MaintenanceMaintaining Routing Displaying log filesDisabling Routing Short-Term Routing ShutdownLong-Term Routing Shutdown Routing Gateway Menu Options Start the Transmission ProcessorStop the Transmission Processor Stop the Evaluation Processor Start the Evaluation ProcessorImport Routing Rules Purge all completed entries in the Transmission QueueRe-Queue all failed entries in the Transmission Queue Remove obsolete entries from Transmission QueueDisplay Current Set of Routing Rules This page is intentionally blank Displaying Routed Exams Using VistARad in a Routing SystemTo display a routed exam Using On-Demand Routing VistARad & On-Demand RoutingOn-Demand Routing Requirements To use on-demand routing Routing User Guide This page is intentionally blank Basic Troubleshooting Troubleshooting RoutingGetting Help If… Then…Transmission Processors and Drive Mapping Additional Routing ConsiderationsFactors Affecting Routing Speed Routed Images vs. Routed ExamsPreventing Transmission of Duplicate Exams How the RC Column is PopulatedThis page is intentionally blank Appendix a Appendix a Specified in sending site’s Network Location file Imaging Destination WorksheetFor detailed information about specific fields, see Network Location File SampleDicom Destination Sample Dicom Destination WorksheetRouting Rule Definition Worksheet Routing User Guide Example #1 Sample RulesExample #2 Example #3Example #5 Example #4Example #6 Example #7Routing Setup Checklist MAGDecompressor Setup Appendix B Using MAGDecompressorInstallation LicensingCd \Program Files\VistA\Imaging\MAGDecompressor Enter Sample log entry MAGDecompressor LoggingSelected log file error codes Glossary Glossary Glossary This page is intentionally blank Index See also routing Background Processor 32 balance commandSee also routing operators, routing rule 11, 20 passwords 28 Index