MAG DICOM QUEUE IMAGE (1866)    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.                     |
 +---------------------------------------------------------------+
 
This RPC enters a study into the DICOM Transmission queue.
In the simplest case, a study contains only one image.
More normally, a study consists of several images.
For object types 3 (X-RAY) and 100 (DICOM image), a single image is entered
 | Property of the US Government.                                |
into the transmission queue.
For object type 11 (X-RAY group) , all images for the study are
entered into the transmission queue.
 | 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  |

• IMAGE
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   30
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  The value of this parameter is a pointer to ^MAG(2005).
  This pointer identifies the image that is to be transmitted.
  

• DESTINAT
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   20
  REQUIRED:   YES
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  The value of this field is the name of the DICOM SOP Class Provider
  to which the images are to be transmitted. This name must
  occur in the User Application List file (#2006.585).
  

• LOCATION
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   20
  REQUIRED:   YES
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

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

• ACCESSIO
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   20
  REQUIRED:   NO
  SEQUENCE NUMBER:   4
  DESCRIPTION:   

  The value of this optional parameter is the accession number
  for the study.
  

• REASON
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   100
  REQUIRED:   NO
  SEQUENCE NUMBER:   5
  DESCRIPTION:   

  The value of this optional parameter is a string that represents
  the reason for the transmission of the image.
  This reason will be stored in ^MAG(2006.95) (IMAGE ACCESS LOG).
  

• EMAIL
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   100
  REQUIRED:   NO
  SEQUENCE NUMBER:   6
  DESCRIPTION:   

  The value of this optional parameter is a string that represents
  an e-mail address. This e-mail address is used to transmit a
  message when there are images that cannot be enqueued.
  

• PRIORITY
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   10
  REQUIRED:   NO
  SEQUENCE NUMBER:   7
  DESCRIPTION:   

  The value of this parameter is a positive integer number.
  This value indicates the relative priority of an entry in the
  transmission queue. A higher number indicates a higher priority.
  The default value of this optional parameter is 500.
  

• JBTOHD
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   10
  REQUIRED:   NO
  SEQUENCE NUMBER:   8
  DESCRIPTION:   

  The value of this parameter is a boolean switch that indicates
  whether or not a copy of the image file(s) is to be made on
  RAID. A true value indicates that a copy on magnetic storage
  is to be made, a false value indicates that no such copy is
  to be made.
  

The output value of this RPC indicates whether or not the
queuing of the image(s) was successful. If successful, the return
value is always equal to 1. Possible error messages:
  OUT="-1,No Image specified"
  OUT="-2,No Destination specified"
  OUT="-3,No Origin specified"