MAG DICOM ROUTE EVAL START (1869)    REMOTE PROCEDURE (8994)

Name Value
NAME MAG DICOM ROUTE EVAL START
TAG START
ROUTINE MAGDRPC5
RETURN VALUE TYPE SINGLE VALUE
AVAILABILITY RESTRICTED
INACTIVE ACTIVE
CLIENT MANAGER 0
WORD WRAP ON TRUE
VERSION 3.0
SUPPRESS RDV USER SETUP No
DESCRIPTION
 +---------------------------------------------------------------+
 | a medical device.  As such, it may not be changed in any way. |
 | Modifications to this software may result in an adulterated   |
 | medical device under 21CFR820, the use of which is considered |
 | to be a violation of US Federal Statutes.                     |
 +---------------------------------------------------------------+
 
Start one rule evaluator to evaluate the newly acquired
images for one specific location.
 
The rule-evaluators will run on the VistA system. They will be
 | Property of the US Government.                                |
started and stopped, however, from the DICOM Gateways.
 | No permission to copy or redistribute this software is given. |
 | Use of unreleased versions of this software requires the user |
 | to execute a written test agreement with the VistA Imaging    |
 | Development Office of the Department of Veterans Affairs,     |
 | telephone (301) 734-0100.                                     |
 |                                                               |
 | The Food and Drug Administration classifies this software as  |
INPUT PARAMETER
  • LOCATION
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    The value of this parameter is a pointer to ^DIC(4).
    This pointer identifies the location at which images were acquired.
    
  • RULES
    PARAMETER TYPE:   LIST
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    The value of this parameter is an array (one integer subscript).
     
    When the second piece is equal to "ACTION", there may be one or more
    additional pieces. If there is only an additional third piece,
    this piece represents the action-verb ("SEND" or "BALANCE"
    currently).
    When there are four or more pieces, the third piece represents
    the sequence number of the command-parameter, and the additional
    pieces represent the command-specific parameters.
     
    When the second piece is equal to "PRIORITY", the third piece
    This array contains the routing rules. Each element of this
    will indicate the relative priority. Typical values are "LOW",
    "MEDIUM" and "HIGH".
     
    When the second piece is equal to "CONDITION", there are either
    five or seven pieces in total. 
    In that case, the third piece always represents the sequence number
    of the current condition for the current rule.
    When there are five pieces,
    the fourth and fifth are a keyword=value pair and describe
    the nature of the condition. Valid keywords are "KW" (keyword),
    array represents one part of a rule; the strings in these elements
    "DT" (data-type), "OP" (operator) and "VA" (value).
    A sequence of seven pieces only occurs when the data-type is
    equal to DT (Date/Time). When there are seven pieces, the fourth
    piece is always equal to "VA" (value) and the fifth through seventh
    pieces indicate a possible date/time range that applies for the
    condition.
     
    Note that conditions are always ANDed with one another, and
    the multiple date/time ranges for a date/time value are always
    ORed with one another.
    each contain a number of fields, separated by carets ("^").
     
    In all rule-elements, the first caret-piece is the rule-number.
     
    The second piece is equal to either "ACTION", "CONDITION"
    or "PRIORITY".
    
RETURN PARAMETER DESCRIPTION
The value of this parameter is one of:
  "0,TaskMan task#=nnn"
  "-1,No Location Specified"
  "-2,No Routing Rules Specified"
  "-3,A Rule Evaluator is Already Running for <location>"
  "-4,TaskMan did not Accept Request"