VistA Analysis » VistA Reference » RPCs » MAG CFIND QUERY
MAG CFIND QUERY
| +—————————————————————+ | 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 performs a DICOM C-FIND request. A request is executed through a TaskMan process,which stores the results in temporary storage (^MAGDQR(2006.5732)). Subsequent calls to this same RPC will retrieve theresults from the result-set to the client. A final call to this RPC will clean up the temporary storage. |
Properties
| Property | Value |
|---|---|
| Label | FIND |
| MUMPS Implementation | MAGDQR01 |
| Return Type | ARRAY |
Input Parameters
| Name | Type | Maximum Data Length | Required | Description | |||
|---|---|---|---|---|---|---|---|
| TAGS | LIST | 32000 | true | This parameter is an array. Each element in this arrayhas a value that looks like: tag | VR | flag | value Each 'tag' is a DICOM tag (two groups of 4 hexadecimaldigits, separated by a comma). When the value is non-empty, it will be used as a searchcriterion in the actual C-Find processing. |
| RESULT | LITERAL | 20 | true | The value of this parameter is an integer number thatidentifies a Result-Set. The value of this parameter is either 0 (when a newresult-set is to be created) or equal to the internalentry number of an existing result-set. | |||
| OFFSET | LITERAL | 20 | true | The value of this parameter is an integer number.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 buildingthe result-set, and if so, return the first batch ofresults. When the value of this number is greater than 0,the RPC will return the next batch of results, startingfrom 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. | |||
| MAX | LITERAL | 10 | true | The value of this parameter is an integer number.This value indicates the number of results to be returnedin each call to this RPC. | |||
| AENAME | LITERAL | 127 | true | 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). |
Document generated on August 31st 2022, 2:55:43 pm