MAG DOD GET STUDIES IEN (2724)    REMOTE PROCEDURE (8994)

This Remote Procedure returns information about studies,
based upon the IEN (File #2005 or #2005.1) of the image group, Patient Number,
Study-Level Only Flag, and Include Deleted Images Flag that are provided as parameters.

• GROUPS
  PARAMETER TYPE:   LIST
  MAXIMUM DATA LENGTH:   1000
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  This parameter can either be provided as a single value or as an array.
  Each value found (either GROUPS or GROUPS(i)) will be evaluated by the Remote Procedure.
  Each value found must be the IEN in file #2005 or #2005.1 of a group of images.
  For each group specified, the Remote Procedure will find the study to which
  that group belongs, and then return
  a hierarchical list of all series and images in that study.
  

• REQDFN
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   50
  REQUIRED:   YES
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  This parameter is Patient Number who owns the images.
  

• IMGLESS
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   1
  REQUIRED:   NO
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

  This parameter is an indicator whether to get only Study-Level or include all images.
  Pass "1" to get only Study-Level data.
  Pass null or empty string to include all images.
  

• FLAGS
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   1
  REQUIRED:   YES
  SEQUENCE NUMBER:   4
  DESCRIPTION:   

  This parameter is a set of indicators that will activate optional return 
  information.
  If FLAGS contains "D", the return will include Deleted Images.
  If FLAGS contains "S", the return will include the Series Description.
  

This Remote Procedure returns an array with information.
For example:
    OUT(1)=17
    OUT(2)="STUDY_UID|1.2.840.113754.1.4.660.1.108"
    OUT(3)="STUDY_PAT|35|9865827312V582731|IMAGPATIENT35,35"
    OUT(4)="SERIES_UID|"
    OUT(5)="SERIES_IEN|6196"
    OUT(6)="SERIES_NUMBER|1"
    OUT(7)="IMAGE_UID|1.2.840.113754.1.4.660.1.108.59498.43402.0"
    OUT(8)="IMAGE_IEN|6197"
    OUT(9)="IMAGE_NUMBER|1"
If there is an error in the execution of the Remote Procedure,
   OUT(10)="IMAGE_ABSTRACT|\\vhaiswclu4\User1$\EdD\Image_Gold\DM\00\61\DM006197.ABS"
   OUT(11)="IMAGE_FULL|\\vhaiswclu4\User1$\EdD\Image_Gold\DM\00\61\DM006197.DCM"
   OUT(12)="IMAGE_TEXT|\\vhaiswclu4\User1$\EdD\Image_Gold\DM\00\61\DM006197.TXT"
   OUT(13)="IMAGE_UID|1.2.840.113754.1.4.660.1.108.59498.43402.1"
   OUT(14)="IMAGE_IEN|6198"
   OUT(15)="IMAGE_NUMBER|1"
   OUT(16)="IMAGE_ABSTRACT|\\vhaiswclu4\User1$\EdD\Image_Gold\DM\00\61\DM006198.ABS"
   OUT(17)="IMAGE_FULL|\\vhaiswclu4\User1$\EdD\Image_Gold\DM\00\61\DM006198.DCM"
   OUT(18)="IMAGE_TEXT|\\vhaiswclu4\User1$\EdD\Image_Gold\DM\00\61\DM006198.TXT"
the first element of this array with start with a negative number,
and the rest of the value in that array element will describe the error.
 
Otherwise, the value of the first element is the number of valid further elements
and each further element of the output array will follow the
general format of a keyword, then a vertical bar, and then one or more
values associated with that keyword.