MAG DOD GET STUDIES IEN

TITLEVALUE
NAMEMAG DOD GET STUDIES IEN
DESCRIPTIONThis 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.
TAGSTUDY2
ROUTINEMAGDQR21
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERGROUPS
DESCRIPTIONThis 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.
PARAMETER TYPELIST
REQUIREDYES
MAXIMUM DATA LENGTH1000
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERREQDFN
DESCRIPTIONThis parameter is Patient Number who owns the images.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH50
INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERIMGLESS
DESCRIPTIONThis 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.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH1
INPUT PARAMETERSSEQUENCE NUMBER4
INPUT PARAMETERFLAGS
DESCRIPTIONThis 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.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH1
RETURN VALUE TYPEARRAY
RETURN PARAMETER DESCRIPTIONThis Remote Procedure returns an array with information.
If there is an error in the execution of the Remote Procedure,
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.
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"
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"
AVAILABILITYRESTRICTED
INACTIVEACTIVE
CLIENT MANAGER
WORD WRAP ONFALSE
VERSION3
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED