Name	Value
NAME	MAG CFIND QUERY
TAG	FIND
ROUTINE	MAGDQR01
RETURN VALUE TYPE	ARRAY
AVAILABILITY	RESTRICTED
INACTIVE	ACTIVE
WORD WRAP ON	FALSE
VERSION	3
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 performs a DICOM C-FIND request. A request is executed through a TaskMan process, which stores the results in temporary storage (^MAGDQR(2006.5732)). \| Property of the US Government. \| Subsequent calls to this same RPC will retrieve the results from the result-set to the client. A final call to this RPC will clean up the temporary storage. \| 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	TAGS PARAMETER TYPE: LIST MAXIMUM DATA LENGTH: 32000 REQUIRED: YES SEQUENCE NUMBER: 1 DESCRIPTION: This parameter is an array. Each element in this array has a value that looks like: tag \| VR \| flag \| value Each 'tag' is a DICOM tag (two groups of 4 hexadecimal digits, separated by a comma). When the value is non-empty, it will be used as a search criterion in the actual C-Find processing. RESULT PARAMETER TYPE: LITERAL MAXIMUM DATA LENGTH: 20 REQUIRED: YES SEQUENCE NUMBER: 2 DESCRIPTION: The value of this parameter is an integer number that identifies a Result-Set. The value of this parameter is either 0 (when a new result-set is to be created) or equal to the internal entry number of an existing result-set. OFFSET PARAMETER TYPE: LITERAL MAXIMUM DATA LENGTH: 20 REQUIRED: YES SEQUENCE NUMBER: 3 DESCRIPTION: The value of this parameter is an integer number. the RPC will return the next batch of results, starting from the one indicated by the value of this parameter. When the value of this number is less than 0, the RPC will clean up the result-set. When the value of this number is equal to 0, the RPC will either create a new result-set, (when the value of RESULT is also equal to 0), or else check whether TaskMan has finished building the result-set, and if so, return the first batch of results. When the value of this number is greater than 0, MAX PARAMETER TYPE: LITERAL MAXIMUM DATA LENGTH: 10 REQUIRED: YES SEQUENCE NUMBER: 4 DESCRIPTION: The value of this parameter is an integer number. This value indicates the number of results to be returned in each call to this RPC. AENAME PARAMETER TYPE: LITERAL MAXIMUM DATA LENGTH: 127 REQUIRED: NO SEQUENCE NUMBER: 5 DESCRIPTION: This is the name of the DICOM Application Entity performing the query. It may be mapped to an entry on the DICOM AE SECURITY MATRIX file (#2006.9192).
RETURN PARAMETER DESCRIPTION	The return parameter of this RPC is an array. valid data elements (successful completion) or error messages (failure). The first element of this array indicates whether or not the RPC completed successfully: a positive number indicates success, a negative number indicates a failure. A zero value indicates success, but with no further data to be returned. The rest of the elements in the array contain either

MAG CFIND QUERY (2196) REMOTE PROCEDURE (8994)