Files > DICOM QUERY RETRIEVE RESULT

name

DICOM QUERY RETRIEVE RESULT

number

2006.5732

location

^MAGDQR(2006.5732,

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. | | | +---------------------------------------------------------------+ The entries in this table are the result-sets that are created in response to DICOM Query/Retrieve requests that may be processed through Remote Procedure Calls. Each entry in this table is one such result-set. Result-sets are kept in this table, so that client-stations can call Remote Procedures to obtain the content of a result-set in portions of a limited size. Also, since the creation of a result-set may need more time than is reasonable wait for in a single Remote Procedure Call, the existence of this table makes it possible to call a first Remote Procedure to create the result-set through a TaskMan process and then call subsequent Remote Procedures to inquire whether the result-set is complete, and subsequently to obtain the results.

Fields

#	Name	Location	Type	Details	Index	Description
.01	result(+)	0;1	NUMERIC		B	The value of this field is an integer number. This number uniquely identifies a result-set that results from a DICOM Query/Retrieve request. The rest of the record is the result-set in question.
2	status	0;2	SET OF CODES	IP:Query in progress OK:Query complete X:Query completely reported		The value of this field is a code that indicates the status of a query. When a query is initiated, the value of this field will be set to IP = In Progress. When a query is complete, the value of this field will be changed to OK = Query Complete. When all results that are logged for the query have been reported, the value of this field will be set to X = Query Completely Reported, so that a clean-up process may remove the now obsolete result-set. (See also the field TIMESTAMP.)
3	timestamp	0;3	DATE-TIME			The value of this field is a timestamp that indicates when a result-set was last accessed. This value is set to the current date and time when the result-set is first marked as complete, and will be updated each time a (partial) result is reported. The main purpose of this field to to assist a maintenance process in cleaning up result-sets that haven't been accessed in more than a couple of days.
4	tag	1;0	MULTIPLE	2006.57321
5	taskman	0;4	NUMERIC			The value of this field is a number. This number is returned by TaskMan when a new background process is created to perform the actual query. This number will be used to query TaskMan to see whether the background process has completed. Note: if the background process is no longer active, and no result-set has been delivered, the error log should be checked for any problems.