MAG DICOM QUEUE IMAGE

TITLEVALUE
NAMEMAG DICOM QUEUE IMAGE
DESCRIPTION +---------------------------------------------------------------+
| Property of the US Government. |
| 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 |
| 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
into the transmission queue.
For object type 11 (X-RAY group) , all images for the study are
entered into the transmission queue.
TAGQUEUE
ROUTINEMAGDRPC3
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERIMAGE
DESCRIPTIONThe value of this parameter is a pointer to ^MAG(2005).
This pointer identifies the image that is to be transmitted.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH30

INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERDESTINAT
DESCRIPTIONThe 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).
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH20

INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERLOCATION
DESCRIPTIONThe value of this parameter is a pointer to ^DIC(4).
This pointer identifies the location at which images were acquired.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH20

INPUT PARAMETERSSEQUENCE NUMBER4
INPUT PARAMETERACCESSIO
DESCRIPTIONThe value of this optional parameter is the accession number
for the study.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH20

INPUT PARAMETERSSEQUENCE NUMBER5
INPUT PARAMETERREASON
DESCRIPTIONThe 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).
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH100

INPUT PARAMETERSSEQUENCE NUMBER6
INPUT PARAMETEREMAIL
DESCRIPTIONThe 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.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH100

INPUT PARAMETERSSEQUENCE NUMBER7
INPUT PARAMETERPRIORITY
DESCRIPTIONThe 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.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH10

INPUT PARAMETERSSEQUENCE NUMBER8
INPUT PARAMETERJBTOHD
DESCRIPTIONThe 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.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH10

RETURN VALUE TYPESINGLE VALUE
RETURN PARAMETER DESCRIPTIONThe 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"
AVAILABILITYRESTRICTED
INACTIVEACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION3
SUPPRESS RDV USER SETUPNo
APP PROXY ALLOWED