STANDARD DATA DICTIONARY #2006.542 -- DICOM RETRIEVE REQUEST QUEUE FILE 3/24/25 PAGE 1
STORED IN ^MAGDSTT(2006.542, *** NO DATA STORED YET *** SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 3.0)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
+---------------------------------------------------------------+
| |
| 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. |
| |
+---------------------------------------------------------------+
The DICOM RETRIEVE REQUEST QUEUE is located on the DICOM Gateway.
This file holds retrieve requests that are generated by VistA and DICOM Gateway to be handled by a Retrieve Client Process on the
DICOM Gateway.
The DICOM Gateway Retrieve Client Process uses the MAG DICOM Q/R CLIENT to pass retrieve status information back to the VistA Q/R
client.
This file should be truncated periodically, as there is no need for the information in this file after the retrieve request has
been processed.
DD ACCESS: @
RD ACCESS: @
WR ACCESS: @
DEL ACCESS: @
LAYGO ACCESS: @
AUDIT ACCESS: @
CROSS
REFERENCED BY: STATUS(B)
LAST MODIFIED: MAR 15,2021@11:53:59
2006.542,.01 STATUS 0;1 SET (Required)
'1' FOR CREATED;
'2' FOR BEING PROCESSED;
'3' FOR SUCCESS;
'4' FOR ERROR;
LAST EDITED: AUG 23, 2019
HELP-PROMPT: Enter the status of the retrieve request.
DESCRIPTION:
Status of retrieve request.
CROSS-REFERENCE: 2006.542^B
1)= S ^MAGDSTT(2006.542,"B",$E(X,1,30),DA)=""
2)= K ^MAGDSTT(2006.542,"B",$E(X,1,30),DA)
2006.542,2 ERROR 0;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>70!($L(X)<3) X
MAXIMUM LENGTH: 70
LAST EDITED: SEP 16, 2019
HELP-PROMPT: Enter the error text, if an error has occurred. Enter 3 to 70 characters.
DESCRIPTION: If an error is encountered in processing a retrieve request, the error message is placed in this
field.
2006.542,3 TIMESTAMP 0;3 DATE (Required)
TIME OF LAST ACTIVITY
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: SEP 16, 2019
HELP-PROMPT: Enter the date/time of the last activity of the retrieval request.
DESCRIPTION:
Timestamp of the last activity of the request.
2006.542,101 RETRIEVE KEYS 1;0 Multiple #2006.5421
DESCRIPTION: These are the search keys that are used in a Retrieve request. Each Retrieve search key consists
of a name/value pair. The search keys are used to identify the patient, study, series or image.
They also specify the destination storage provider for the DICOM objects that are retrieved.
2006.5421,.01 KEY NAME 0;1 FREE TEXT (Required) (Multiply asked)
INPUT TRANSFORM: K:$L(X)>30!($L(X)<3) X
MAXIMUM LENGTH: 30
LAST EDITED: SEP 16, 2019
HELP-PROMPT: Enter the name of the retrieve key, 3 to 30 characters.
DESCRIPTION:
This is the name of the retrieve key, 3 to 30 characters.
CROSS-REFERENCE: 2006.5421^B
1)= S ^MAGDSTT(2006.542,DA(1),1,"B",$E(X,1,30),DA)=""
2)= K ^MAGDSTT(2006.542,DA(1),1,"B",$E(X,1,30),DA)
2006.5421,2 KEY VALUE 0;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>100!($L(X)<1) X
MAXIMUM LENGTH: 100
LAST EDITED: SEP 16, 2019
HELP-PROMPT: Enter the value of the retrieve key, 1 to 100 characters.
DESCRIPTION: This is the value of the retrieve key.
Note: DICOM Person Name data elements contain carets (^) between the name components. The carets
have been replaced with tildes (~) in this field, so as not to be confused with the MUMPS field
separators. The tildes need to be switched back to carets when the Person Name is used as a
DICOM Q/R key.
2006.542,201 STUDY UID 2;0 Multiple #2006.5422
DESCRIPTION: In a STUDY-level retrieve, the Study Instance UID (0020,000D) multiple is used to retrieve one or
more studies from the PACS. In a SERIES-level or IMAGE-level retrieve, the Study Instance UID is
single-valued and must be specified.
2006.5422,.01 STUDY UID 0;1 FREE TEXT (Multiply asked)
STUDY INSTANCE UID
INPUT TRANSFORM: K:$L(X)>100!($L(X)<10) X
MAXIMUM LENGTH: 100
LAST EDITED: SEP 16, 2019
HELP-PROMPT: Enter the Study UID, 10 to 100 characters.
DESCRIPTION:
This is the Study Instance UID for the retrieve request.
CROSS-REFERENCE: 2006.5422^B
1)= S ^MAGDSTT(2006.542,DA(1),2,"B",$E(X,1,100),DA)=""
2)= K ^MAGDSTT(2006.542,DA(1),2,"B",$E(X,1,100),DA)
2006.542,301 SERIES UID 3;0 Multiple #2006.5423
DESCRIPTION: In a SERIES-level retrieve, the Series Instance UID (0020,000E) multiple is used to retrieve one or
more series from the PACS. In an IMAGE-level retrieve, the Series Instance UID is single-valued
and must be specified.
2006.5423,.01 SERIES UID 0;1 FREE TEXT (Multiply asked)
SERIES INSTANCE UID
INPUT TRANSFORM: K:$L(X)>100!($L(X)<10) X
MAXIMUM LENGTH: 100
LAST EDITED: SEP 16, 2019
HELP-PROMPT: Enter the Series Instance UID, 10 thru 100 characters.
DESCRIPTION:
This is the Series Instance UID for the retrieve request.
CROSS-REFERENCE: 2006.5423^B
1)= S ^MAGDSTT(2006.542,DA(1),3,"B",$E(X,1,100),DA)=""
2)= K ^MAGDSTT(2006.542,DA(1),3,"B",$E(X,1,100),DA)
2006.542,401 SOP UID 4;0 Multiple #2006.5424
DESCRIPTION: In an IMAGE-level retrieve, the SOP Instance UID (0008,0018) multiple is used to retrieve one or
more composite SOP instances (images) from the PACS.
2006.5424,.01 SOP UID 0;1 FREE TEXT (Multiply asked)
SOP Instance UID
INPUT TRANSFORM: K:$L(X)>100!($L(X)<10) X
MAXIMUM LENGTH: 100
LAST EDITED: SEP 16, 2019
HELP-PROMPT: Enter the SOP Instance UID, 10 to 100 characters.
DESCRIPTION:
This is the SOP Instance UID for the retrieve request.
CROSS-REFERENCE: 2006.5424^B
1)= S ^MAGDSTT(2006.542,DA(1),4,"B",$E(X,1,100),DA)=""
2)= K ^MAGDSTT(2006.542,DA(1),4,"B",$E(X,1,100),DA)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):