MAG DICOM ROUTE NEXT FILE (1876)    REMOTE PROCEDURE (8994)

Name Value
NAME MAG DICOM ROUTE NEXT FILE
TAG XMIT
ROUTINE MAGDRPC5
RETURN VALUE TYPE ARRAY
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.                     |
 +---------------------------------------------------------------+
 
The Routing Transmitter will continuously ask the VistA system
for the next file to transmit. This RPC will be called to obtain
the name of the next file to be transmitted.
 
 | Property of the US Government.                                |
This RPC returns information about the next image file to be
transmitted by a certain Routing Transmitter.
 
The next file to be transmitted is either the next file for
the current destination, or the next file with the highest
priority in any of the queues for the destinations that are
being served by the current transmitter.
 
If neither of the parameters DEST and PRIOR have a non-empty
value, information about the first file (if any) to be transmitted
 | No permission to copy or redistribute this software is given. |
will be returned.
 | 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.
    
  • DEST
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   NO
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    The value of this parameter is a pointer to either ^MAG(2005.2)
    or ^MAGDICOM(2006.585).
    This pointer identifies the destination to which the images
    are to be transmitted.
    
  • PRIOR
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   NO
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    The value of this parameter is an integer number (> 0).
    This number establishes the priority of the new entry in its queue.
    
  • MECH
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   10
    REQUIRED:   NO
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    The value of this parameter is an integer value (1 or 2).
    This number defines the mechanism that will be used to transmit
    the images:
       1 = standard copy
       2 = DICOM copy
    
  • DESTS
    PARAMETER TYPE:   LIST
    REQUIRED:   YES
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    This parameter is an array containing the list of destinations
    The second piece is a pointer. When the first piece is equal
    to 1, this pointer points to table # 2005.2 (Network Location);
    when the first piece is equal to 2, this pointer points to
    table # 2006.585 (User Application).
    that is being served by the current transmitter.
    The values in this array each are string with two pieces of data,
    separated by a caret ("^").
     
    The first piece describes the transmission mechanism:
      1 = regular copy
      2 = DICOM copy
     
    
RETURN PARAMETER DESCRIPTION
The output parameter is an array.
   OUT(3)=PRIOR
   OUT(4)=MECH
   OUT(5)=logical name for destination
   OUT(6)=physical name for destination
   OUT(7)='from' file name
   OUT(8)='to' file name
   OUT(9)=D0 (^MAGQUEUE(2006.035))
The meaning of the various elements is:
   OUT(1) = 0: all OK
            2: no files to be transmitted for this image
            3: cannot yet transmit, purge first
           -1: No Location Specified
           -2: No Valid Destinations Specified
If OUT(1) is equal to 0, the other elements are defined as:
   OUT(2)=DEST