MAG STUDY UID QUERY (2200) REMOTE PROCEDURE (8994)

Name	Value
NAME	MAG STUDY UID QUERY
TAG	STUDY
ROUTINE	MAGDQR04
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 returns information about the images that were acquired for a specific study. \| 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	UID PARAMETER TYPE: LITERAL MAXIMUM DATA LENGTH: 64 REQUIRED: YES SEQUENCE NUMBER: 1 DESCRIPTION: The value of this parameter is a string. This string is a DICOM UID (unique identifier) that specifies the study for which the image information is to be retrieved. A DICOM UID is a string consisting of only digits and periods, and may be up to 64 characters long. PRMUID PARAMETER TYPE: LITERAL MAXIMUM DATA LENGTH: 1 REQUIRED: NO SEQUENCE NUMBER: 2 DESCRIPTION: The primary UID flag determines what type of error checks will be A multiple UID check can be performed which will check to see if the PACS UID is associated with multiple entries in the IMAGE (#2005) file. If multiple UIDs are found a "-14" error will be returned. A PRMUID value of 0 will perform a duplicate and multiple UID check. A PRMUID value of 1 will perform neither a duplicate nor multiple performed on the UID provided. UID check. A PRMUID value of 2 will perform a duplicate UID check, but will not perform a multiple UID check. There are two UID checks that may be performed depending on the value of the primary UID flag. A duplicate UID check can be performed which will check to see if the PACS UID is associated with multiple patients. If duplicate UIDs are found a "-13" error message will be returned.
RETURN PARAMETER DESCRIPTION	The return parameter of this RPC is an array. The first element indicates success or failure: a negative value indicates an error status, a non-negative value indicates the number of images found for the specified Study UID. The other elements of the output array all have the following format: image# ^ filename ^ username ^ password (encrypted)