STANDARD DATA DICTIONARY #2006.541 -- DICOM VISTA Q/R REQUEST QUEUE FILE                                          5/26/26    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.                                | 
 |                                                               |
 | 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: DIVISION(B)

    LAST MODIFIED: MAR 26,2026@15:11:30

2006.541,.01  DIVISION               0;1 POINTER TO INSTITUTION FILE (#4) (Required)

              LAST EDITED:      JUL 05, 2022 
              HELP-PROMPT:      Enter the user's division for the Q/R request. 
              DESCRIPTION:      This is the user's location from DUZ(2).  
                                 

              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,1    DICOM VISTA Q/R REQUESTS 1;0 Multiple #2006.5411

              DESCRIPTION:
                                DICOM VistA Q/R requests for the DIVISION.  


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

                INPUT TRANSFORM:  S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
                LAST EDITED:      JUL 05, 2022 
                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.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     QUERY/RETRIEVE FLAG    0;2 SET (Required)

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


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

                INPUT TRANSFORM:  K:$L(X)>30!($L(X)<10) X
                MAXIMUM LENGTH:   30
                LAST EDITED:      JUL 05, 2022 
                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.5411,4     HOSTNAME               0;4 FREE TEXT (Required)

                INPUT TRANSFORM:  K:$L(X)>15!($L(X)<10) X
                MAXIMUM LENGTH:   15
                LAST EDITED:      JUL 05, 2022 
                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.5411,5     JOB NUMBER             0;5 NUMBER (Required)

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


2006.5411,6     QRSTACK                0;6 NUMBER (Required)

                INPUT TRANSFORM:  K:+X'=X!(X>10)!(X<1)!(X?.E1"."1N.N) X
                LAST EDITED:      JUL 05, 2022 
                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.5411,7     DUZ                    0;7 POINTER TO NEW PERSON FILE (#200) (Required)

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


2006.5411,101   Q/R KEYS               1;0 Multiple #2006.54111

                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.54111,.01    KEY NAME               0;1 FREE TEXT (Required) (Multiply asked)

                  INPUT TRANSFORM:  K:$L(X)>30!($L(X)<1) X
                  MAXIMUM LENGTH:   30
                  LAST EDITED:      JUL 05, 2022 
                  HELP-PROMPT:      Enter the name of the Q/R key (1-30 characters). 
                  DESCRIPTION:
                                    This is the name of the Q/R key.  

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


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

                  INPUT TRANSFORM:  K:$L(X)>100!($L(X)<1) X
                  MAXIMUM LENGTH:   100
                  LAST EDITED:      JUL 05, 2022 
                  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.  






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   REQUEST TIMESTAMP      0;1 DATE (Required)

                INPUT TRANSFORM:  S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
                LAST EDITED:      JUL 05, 2022 
                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.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     QUERY/RETRIEVE FLAG    0;2 SET (Required)

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


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

                INPUT TRANSFORM:  K:$L(X)>30!($L(X)<10) X
                MAXIMUM LENGTH:   30
                LAST EDITED:      JUL 05, 2022 
                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.5411,4     HOSTNAME               0;4 FREE TEXT (Required)

                INPUT TRANSFORM:  K:$L(X)>15!($L(X)<10) X
                MAXIMUM LENGTH:   15
                LAST EDITED:      JUL 05, 2022 
                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.5411,5     JOB NUMBER             0;5 NUMBER (Required)

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


2006.5411,6     QRSTACK                0;6 NUMBER (Required)

                INPUT TRANSFORM:  K:+X'=X!(X>10)!(X<1)!(X?.E1"."1N.N) X
                LAST EDITED:      JUL 05, 2022 
                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.5411,7     DUZ                    0;7 POINTER TO NEW PERSON FILE (#200) (Required)

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


2006.5411,101   Q/R KEYS               1;0 Multiple #2006.54111

                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.54111,.01    KEY NAME               0;1 FREE TEXT (Required) (Multiply asked)

                  INPUT TRANSFORM:  K:$L(X)>30!($L(X)<1) X
                  MAXIMUM LENGTH:   30
                  LAST EDITED:      JUL 05, 2022 
                  HELP-PROMPT:      Enter the name of the Q/R key (1-30 characters). 
                  DESCRIPTION:
                                    This is the name of the Q/R key.  

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


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

                  INPUT TRANSFORM:  K:$L(X)>100!($L(X)<1) X
                  MAXIMUM LENGTH:   100
                  LAST EDITED:      JUL 05, 2022 
                  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

INSTITUTION (#4)                  DIVISION (#.01)

NEW PERSON (#200)                 DUZ (#7)
                                  DICOM VISTA Q/R REQUESTS:DUZ (#7)



INPUT TEMPLATE(S):

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):