STANDARD DATA DICTIONARY #2006.541 -- DICOM VISTA Q/R REQUEST QUEUE FILE                                          3/24/25    PAGE 1
STORED IN ^MAGDSTT(2006.541,  *** 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.                     | 
 |                                                               |
 +---------------------------------------------------------------+
 
This file holds the Query/Retrieve requests that are generated by VistA to be performed by the DICOM Gateway.  
 
The DICOM Gateway uses the MAG DICOM Q/R CLIENT to read this file and to pass 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 Q/R request has been
processed.  


              DD ACCESS: @
              RD ACCESS: @
              WR ACCESS: @
             DEL ACCESS: @
           LAYGO ACCESS: @
           AUDIT ACCESS: @

CROSS
REFERENCED BY: REQUEST TIMESTAMP(B)

    LAST MODIFIED: MAR 15,2021@11:53:59

2006.541,.01  REQUEST TIMESTAMP      0;1 DATE (Required)

              REQUEST DATE/TIME   
              INPUT TRANSFORM:  S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
              LAST EDITED:      SEP 16, 2019 
              HELP-PROMPT:      Enter the Fileman date/time of the Q/R request. 
              DESCRIPTION:      This is the Fileman date/time of the request.  
                                 

              CROSS-REFERENCE:  2006.541^B 
                                1)= S ^MAGDSTT(2006.541,"B",$E(X,1,30),DA)=""
                                2)= K ^MAGDSTT(2006.541,"B",$E(X,1,30),DA)


2006.541,2    QUERY/RETRIEVE FLAG    0;2 SET (Required)

                                'Q' FOR QUERY; 
                                'R' FOR RETRIEVE; 
              LAST EDITED:      SEP 16, 2019 
              HELP-PROMPT:      Select either a Query or Retrieve request type. 
              DESCRIPTION:
                                This field indicates whether this is a Query or a Retrieve request.  


2006.541,3    FIRST XTMP SUBSCRIPT   0;3 FREE TEXT (Required)

              INPUT TRANSFORM:  K:$L(X)>30!($L(X)<10) X
              MAXIMUM LENGTH:   30
              LAST EDITED:      JAN 27, 2020 
              HELP-PROMPT:      Enter the first ^XTMP subscript for a query request, limited to 10 to 30 characters. 
              DESCRIPTION:      This is the first subscript of the ^XTMP global created to temporarily hold the results of a DICOM
                                Query. It needs to be ^XTMP rather than ^TMP because ^XTMP is translated whereas ^TMP is not.  


2006.541,4    HOSTNAME               0;4 FREE TEXT (Required)

              INPUT TRANSFORM:  K:$L(X)>15!($L(X)<10) X
              MAXIMUM LENGTH:   15
              LAST EDITED:      FEB 05, 2020 
              HELP-PROMPT:      Enter the name of the computer (HOSTNAME).  It must be between 10 and 15 characters long. 
              DESCRIPTION:
                                This is the name of the computer generating the query/retrieve request.  


2006.541,5    JOB NUMBER             0;5 NUMBER (Required)

              INPUT TRANSFORM:  K:+X'=X!(X>99999999)!(X<1)!(X?.E1"."1N.N) X
              LAST EDITED:      FEB 05, 2020 
              HELP-PROMPT:      Enter the Job Number ($J) of the VistA process issuing the Q/R request, a number between 1 and 
                                99999999. 
              DESCRIPTION:
                                This is the VistA Job Number ($J).  


2006.541,6    QRSTACK                0;6 NUMBER (Required)

              INPUT TRANSFORM:  K:+X'=X!(X>10)!(X<1)!(X?.E1"."1N.N) X
              LAST EDITED:      FEB 05, 2020 
              HELP-PROMPT:      Enter the number of the Q/R stack in ^TMP (1-10). 
              DESCRIPTION:      This is the number of the entry in the query/retrieve push down stack.  The first number is one,
                                then two, then three, and then four.  When the user goes forward, the stack is built.  When the
                                user goes backwards, the stack is cleared.  


2006.541,7    DUZ                    0;7 POINTER TO NEW PERSON FILE (#200) (Required)

              LAST EDITED:      FEB 05, 2020 
              HELP-PROMPT:      Enter the person who created the entry. 
              DESCRIPTION:
                                User in New Person File (#200) who created the Q/R request entry.  


2006.541,101  Q/R KEYS               1;0 Multiple #2006.5411 (Add New Entry without Asking)

              DESCRIPTION:      These are the search and return keys that are used in a Query/Retrieve request.  Each Q/R key
                                consists of a name/value pair.  The search keys are used to identify the patient, study, series, or
                                image.  In the query message, the return keys are null in the request message and are filled with 
                                information on the response message.  In the retrieve message, the destination storage provider is
                                specified in the query keys.  


2006.5411,.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:      AUG 23, 2019 
                HELP-PROMPT:      Enter the name of the Q/R key. 
                DESCRIPTION:
                                  This is the name of the Q/R key, 1 to 30 characters.  

                CROSS-REFERENCE:  2006.5411^B 
                                  1)= S ^MAGDSTT(2006.541,DA(1),1,"B",$E(X,1,30),DA)=""
                                  2)= K ^MAGDSTT(2006.541,DA(1),1,"B",$E(X,1,30),DA)


2006.5411,2     KEY VALUE              0;2 FREE TEXT (Required)

                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 Q/R key, 1 to 100 characters. 
                DESCRIPTION:      This is the value of the Q/R 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 FM field
                                  separators.  





      FILES POINTED TO                      FIELDS

NEW PERSON (#200)                 DUZ (#7)



INPUT TEMPLATE(S):

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):