STANDARD DATA DICTIONARY #2006.574 -- DICOM OBJECT EXPORT FILE 3/24/25 PAGE 1
STORED IN ^MAGDOUTP(2006.574, *** 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 entries in this table describe requests to transmit image files to an alternate storage provider. The top-level of this table
identifies the storage provider, the next level identifies the images for which files are to be transmitted.
POINTED TO BY: EXPORT IEN field (#.01) of the EXPORT sub-field (#2006.56519) of the EXPORT DICOM RUN File (#2006.565)
CROSS
REFERENCED BY: REQUEST DATE/TIME(C), ACCESSION NUMBER(D)
INDEXED BY: STATE (STATE), STUDY UID & IMAGE DATABASE (STUDY)
LAST MODIFIED: JUN 8,2022@15:48:23
2006.574,.01 APPLICATION 0;1 FREE TEXT (Required)
INPUT TRANSFORM: K:$L(X)>30!($L(X)<3)!'(X'?1P.E) X
LAST EDITED: FEB 22, 2000
HELP-PROMPT: Enter the name of the application that will receive the file(s).
DESCRIPTION: The value of this field is a string that identifies the application that will receive the image
files for which this entry describes the parameters.
The name that is entered here corresponds to the name (.01 field) in file 2006.585 (stored in
^MAGDICOM(2006.585,...) of the storage provider that will receive the image files.
2006.574,2 GROUP 0;2 POINTER TO IMAGE FILE (#2005)
LAST EDITED: FEB 22, 2000
HELP-PROMPT: Identify the group of images that is to be transported.
DESCRIPTION: The value of this field is a pointer that identifies the image that is the 'parent' of the group of
images for which this entry describes the transmission to another storage provider.
The value of this field is a pointer to the Image File (2005, stored in ^MAG(2005,...).
2006.574,3 ACCESSION NUMBER 0;3 FREE TEXT
INPUT TRANSFORM: K:$L(X)>20!($L(X)<1) X
MAXIMUM LENGTH: 20
LAST EDITED: MAR 22, 2021
HELP-PROMPT: Answer must be 1-20 characters in length.
DESCRIPTION: The value of this field is the (short) case number for the study that is referenced in this entry.
A long case number consists of two groups of digits separated by a dash. The first group is 6
digits, and is derived from the date. The second group is an integer number that uniquely
identifies the study for that date.
For this field, the whole accession number is entered.
CROSS-REFERENCE: 2006.574^D
1)= S ^MAGDOUTP(2006.574,"D",$E(X,1,30),DA)=""
2)= K ^MAGDOUTP(2006.574,"D",$E(X,1,30),DA)
Cross-reference by Accession Number
2006.574,4 IMAGE 1;0 POINTER Multiple #2006.5744 (Add New Entry without Asking)
2006.5744,.01 IMAGE 0;1 POINTER TO IMAGE FILE (#2005)
LAST EDITED: FEB 22, 2000
HELP-PROMPT: Identify the image(s) in this transmission.
DESCRIPTION: The value of this field is a pointer that identifies one of the images that is to be transmitted
to another storage provider.
The value of this field is a pointer to the Image File (2005, stored in ^MAG(2005,...).
2006.5744,2 STATE 0;2 SET
'WAITING' FOR Waiting for XMIT;
'XMIT' FOR Transmission (XMIT) in progress;
'FAIL' FOR XMIT failed;
'SUCCESS' FOR XMIT successful;
'HOLD' FOR Hold for XMIT at a later time;
'NOT ON FILE' FOR The image file does not exist;
'IGNORE' FOR Not DICOM, can't XMIT;
LAST EDITED: OCT 26, 2021
HELP-PROMPT: Indicate the current state of this entry.
DESCRIPTION: The value of this field is a code that indicates the current state of the entry in this table.
Possible values are "waiting to be transmitted", "transmission in progress" and "successful
transmission" or "failed transmission".
Three other possible values are "hold transmission for a later time", "ignore file since its not
DICOM", and "not on file".
A cross-reference on this field is used to prevent issuing the same file to multiple transmission
processes.
RECORD INDEXES: STATE (#226) (WHOLE FILE #2006.574)
2006.5744,3 TIMESTAMP 0;3 FREE TEXT
INPUT TRANSFORM: K:$L(X)>15!($L(X)<3)!'(X?1.N1","1.N) X
MAXIMUM LENGTH: 15
LAST EDITED: OCT 26, 2021
HELP-PROMPT: Indicate the current time ($H format) 3-15 characters.
DESCRIPTION: The value of this field is a string ($Horolog format) that indicates the date and time that the
current state was established.
This value is used when checking on files that are in a state of "transmission in progress". When
a file is too long in this state, the current entry will be moved back to a state of "waiting for
transmission".
See the RPC named "MAG DICOM GET NEXT QUEUE ENTRY" for the actual time-lag that decides on a
change-back of the state.
2006.574,5 FROM 0;4 POINTER TO INSTITUTION FILE (#4)
LAST EDITED: OCT 29, 2004
HELP-PROMPT: Enter the name of the site from which the image routing request originates.
DESCRIPTION: The value of this field is a pointer (to the Institution file, #4). This pointer identifies the
location from which the image routing request originated.
2006.574,6 PRIORITY 0;5 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>999999999)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: JUN 02, 2005
HELP-PROMPT: Enter an integer number to represent the priority of this queue entry.
DESCRIPTION: The value of this field is a positive integer number. This number indicates the relative priority
of an entry in the queue.
A higher number indicates a higher priority, i.e. when two entries have different priorities, the
entry with the higher priority will be processed before the one with the lower priority.
2006.574,7 STUDY UID 2;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>64!($L(X)<1)!'(X?1.(1N,1".")) X
LAST EDITED: DEC 21, 2021
HELP-PROMPT: Enter the Study UID for this group of images.
DESCRIPTION: The value of this field is a string that represents a DICOM Unique Object Identifier. A DICOM UID
is a string that consists of up to 64 characters, each character must be either a digit or a
period, no two consecutive periods are allowed, none of the series of consecutive digits may start
with a zero.
This UID identifies the study to which the images belong that are included in the current entry.
RECORD INDEXES: STUDY (#773)
2006.574,8 COPY TO RAID 0;6 SET
'0' FOR Do not copy;
'1' FOR Make a copy;
LAST EDITED: FEB 13, 2006
HELP-PROMPT: Indicate whether or not a copy of the image is to be made on RAID.
DESCRIPTION: The value of this field is a code that indicates whether or not a copy of the image file(s) is to
be made on RAID. A value of 0 indicates that no copy is to be made on RAID. A value of 1
indicates that a copy should be made.
2006.574,9 REQUEST DATE/TIME 0;7 DATE (Required)
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: FEB 28, 2013
HELP-PROMPT: Enter the date and time of the DICOM export request.
DESCRIPTION:
This is the date and time of the DICOM export request.
CROSS-REFERENCE: 2006.574^C
1)= S ^MAGDOUTP(2006.574,"C",$E(X,1,30),DA)=""
2)= K ^MAGDOUTP(2006.574,"C",$E(X,1,30),DA)
This index is used to find old DICOM export requests that need to be deleted.
2006.574,10 IMAGE DATABASE 0;8 SET (Required)
'LEGACY' FOR Legacy database - file #2005;
'NEW' FOR New SOP Class database - file #2005.6x;
LAST EDITED: DEC 21, 2021
HELP-PROMPT: Enter the image database that contains the DICOM object to be exported
DESCRIPTION:
The field indicates which image database contains the DICOM objects to be exported.
RECORD INDEXES: STUDY (#773)
FILES POINTED TO FIELDS
IMAGE (#2005) GROUP (#2)
IMAGE:IMAGE (#.01)
INSTITUTION (#4) FROM (#5)
File #2006.574
Record Indexes:
STUDY (#773) RECORD REGULAR IR LOOKUP & SORTING
Short Descr: Compound xref on Study UID and Image Database
Description: The STUDY cross-reference is used to aggregate image export requests into one entry in the DICOM OBJECT EXPORT
file (#2006.574).
Set Logic: S ^MAGDOUTP(2006.574,"STUDY",$E(X(1),1,64),$E(X(2),1,10),DA)=""
Kill Logic: K ^MAGDOUTP(2006.574,"STUDY",$E(X(1),1,64),$E(X(2),1,10),DA)
Whole Kill: K ^MAGDOUTP(2006.574,"STUDY")
X(1): STUDY UID (2006.574,7) (Subscr 1) (Len 64) (forwards)
X(2): IMAGE DATABASE (2006.574,10) (Subscr 2) (Len 10) (forwards)
Subfile #2006.5744
Record Indexes:
STATE (#226) RECORD REGULAR IR LOOKUP & SORTING WHOLE FILE (#2006.574)
Short Descr: Origin and State
Description:
This cross-reference keeps track of ORIGIN and STATE. The main purpose of this cross-reference is to make sure
that files are issued to only one transmission process.
Set Logic: S ^MAGDOUTP(2006.574,"STATE",X(1),X(2),X(3),DA(1),DA)=""
Kill Logic: K ^MAGDOUTP(2006.574,"STATE",X(1),X(2),X(3),DA(1),DA)
Whole Kill: K ^MAGDOUTP(2006.574,"STATE")
X(1): Computed Code: S X=$P(^MAGDOUTP(2006.574,DA(1),0),"^",4)
(Subscr 1)
Lookup Prompt: Origin
X(2): Computed Code: S X=$P(^MAGDOUTP(2006.574,DA(1),0),"^",5)
(Subscr 2)
X(3): STATE (2006.5744,2) (Subscr 3) (forwards)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):