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

 +---------------------------------------------------------------+
 | 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  |

• 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
   
  

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