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)