| NAME |
MAG DICOM GET NEXT QUEUE ENTRY |
| TAG |
NEXTIMG |
| ROUTINE |
MAGDRPC4 |
| RETURN VALUE TYPE |
ARRAY |
| AVAILABILITY |
RESTRICTED |
| INACTIVE |
ACTIVE |
| CLIENT MANAGER |
0 |
| WORD WRAP ON |
TRUE |
| VERSION |
3 |
| SUPPRESS RDV USER SETUP |
No |
| DESCRIPTION |
+---------------------------------------------------------------+
| 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.
| 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 |
|
| INPUT PARAMETER |
-
- 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,
i.e., from where they are being transmitted.
-
- D0
- PARAMETER TYPE: LITERAL
- MAXIMUM DATA LENGTH: 20
- REQUIRED: NO
- SEQUENCE NUMBER: 2
- DESCRIPTION:
The value of this optional parameter is a pointer into the
DICOM IMAGE OUTPUT file (#2006.574). If this paramater is omitted,
this RPC will find the first (if any) study in this file to be
transmitted. If this parameter is specified, its value is intended
to be the "D0" value for the most recent image transmitted, and this
RPC will find the next (if any) image to be transmitted.
-
- D1
- PARAMETER TYPE: LITERAL
- MAXIMUM DATA LENGTH: 20
- REQUIRED: NO
- SEQUENCE NUMBER: 3
- DESCRIPTION:
The value of this optional parameter is a pointer into the
IMAGE multiple of the
DICOM IMAGE OUTPUT file (#2006.574). If this paramater is omitted,
this RPC will find the first (if any) image in this file for the
current study to be
transmitted. If this parameter is specified, its value is intended
to be the "D1" value for the most recent image transmitted, and this
RPC will find the next (if any) image to be transmitted.
-
- SENT
- PARAMETER TYPE: LIST
- MAXIMUM DATA LENGTH: 10000
- REQUIRED: NO
- SEQUENCE NUMBER: 2
- DESCRIPTION:
This 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.
-
- CHECK
- PARAMETER TYPE: LITERAL
- MAXIMUM DATA LENGTH: 5
- REQUIRED: NO
- SEQUENCE NUMBER: 3
- DESCRIPTION:
The 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.
|
| RETURN PARAMETER DESCRIPTION |
The first element of the output array indicates whether there
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"
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
|
