MAG DICOM ROUTE PURGE DONE (1877)    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.                     |
 +---------------------------------------------------------------+
 
Periodic maintenance on the data in the Transmission Queue 
involves removal of entries that have a state of "SENT" after the 
image files would have been purged from their temporary 
destinations. In order to perform this maintenance, the user of 
 | Property of the US Government.                                |
the DICOM Gateway would invoke a menu option that calls this RPC.
 
This RPC will remove all entries in the Transmission Queue that 
were created for the specified LOCATION and have been in a state 
of "SENT" or "FAILED" for more days than specified.
 | 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  |

• DAYS
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   10
  REQUIRED:   NO
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  The value of this parameter is an integer number.
  This value represents the number of days for which information
  will be retained.
   
  When this parameter is omitted, or when its value is less than 1,
  the retention periods for the destinations of the individual image files
  in question will be used as default values.
  

• LOCATION
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   30
  REQUIRED:   YES
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  The value of this parameter is a pointer to ^DIC(4).
  This pointer identifies the location at which images were acquired.
  

The value of this parameter is an integer number.
 
When the value of this number is negative, it indicates an error
condition. Currently, only one error code is defined:
  -1: No Location Specified
 
When the value of this number is greater than or equal to
zero, it represents the number of queue entries that
have been purged.