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

Name	Value
NAME	MAG DOD GET STUDIES IEN
TAG	STUDY2
ROUTINE	MAGDQR21
RETURN VALUE TYPE	ARRAY
AVAILABILITY	RESTRICTED
INACTIVE	ACTIVE
WORD WRAP ON	FALSE
VERSION	3
DESCRIPTION	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.
INPUT PARAMETER	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.
RETURN PARAMETER 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.