MAG DICOM GET NEXT QUEUE ENTRY

TITLEVALUE
NAMEMAG DICOM GET NEXT QUEUE ENTRY
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 will check if there are any new images to be transmitted,
and will return information about the first or next one (if any)
in the DICOM transmission queue.
TAGNEXTIMG
ROUTINEMAGDRPC4
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERLOCATION
DESCRIPTIONThe value of this parameter is a pointer to ^DIC(4).
This pointer identifies the location at which images were acquired,
i.e., from where they are being transmitted.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH30
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERSENT
DESCRIPTIONThis parameter is an array. Each element of this array
contains internal entry numbers that identify an entry
in the send-queue that has been transmitted successfully.
The RPC will use the contents of this array to remove
entries from the queue that have been transmitted.
PARAMETER TYPELIST
REQUIREDNO
MAXIMUM DATA LENGTH10000
INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERCHECK
DESCRIPTIONThe value of this parameter is a boolean value.
When the value of this parameter is non-zero (true),
the RPC will not mark the queue entry as being "in transmission".
This feature is used when the RPC is being called for the
sole purpose of deternining whether or not there are
any entries in the queue.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH5
RETURN VALUE TYPEARRAY
RETURN PARAMETER DESCRIPTIONThe first element of the output array indicates whether there
are any images to be transmitted.
If there are none, or if there is an error in one or more input parameters,
OUT(1) will reflect this. Otherwise:
OUT(1) = 1
OUT(2) = New value for D0
OUT(3) = New value for D1
OUT(4) = Destination Application
OUT(5) = Group
OUT(6) = Accession number
OUT(7) = Image Number
OUT(8) = Object Type
OUT(9) = File Name (including directory path)
OUT(10) = File Name (file name only)
Possible error messages:
OUT(1)="-1,No Origin Specified"
OUT(1)="-2,No studies to be transmitted"
OUT(1)="-3,No files to be transmitted"
AVAILABILITYRESTRICTED
INACTIVEACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION3
SUPPRESS RDV USER SETUPNo
APP PROXY ALLOWED