| TITLE | VALUE | |
|---|---|---|
| NAME | MAG STUDY UID QUERY | |
| 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. | +---------------------------------------------------------------+ This RPC returns information about the images that were acquired for a specific study. | |
| TAG | STUDY | |
| ROUTINE | MAGDQR04 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 1 |
| INPUT PARAMETER | UID | |
| 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. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | YES | |
| MAXIMUM DATA LENGTH | 64 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 2 |
| INPUT PARAMETER | PRMUID | |
| DESCRIPTION | The primary UID flag determines what type of error checks will be performed on the UID provided. 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. 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 UID check. A PRMUID value of 2 will perform a duplicate UID check, but will not perform a multiple UID check. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | NO | |
| MAXIMUM DATA LENGTH | 1 | |
| RETURN VALUE TYPE | ARRAY | |
| 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) | |
| AVAILABILITY | RESTRICTED | |
| INACTIVE | ACTIVE | |
| CLIENT MANAGER | ||
| WORD WRAP ON | FALSE | |
| VERSION | 3 | |
| SUPPRESS RDV USER SETUP | ||
| APP PROXY ALLOWED | ||