STANDARD DATA DICTIONARY #2006.928 -- QUEUE MESSAGE FILE                                                          3/24/25    PAGE 1
STORED IN ^MAGV(2006.928,  *** 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 stores individual queue messages for a queue.  It contains the message, earliest delivery date/time and expiration
date/time of a message.  This will be used to queue asynchronous storage requests.  


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

CROSS
REFERENCED BY: QUEUE(B)

INDEXED BY:    QUEUE & ENQUEUED DATE/TIME & MESSAGE GROUP ID (ENQBLDT), QUEUE & ENQUEUED DATE/TIME (ENQDT), QUEUE & MESSAGE GROUP
               ID & ENQUEUED DATE/TIME (ENQPLDT)




2006.928,.01  QUEUE                  0;1 POINTER TO QUEUE FILE (#2006.927) (Required)

              LAST EDITED:      OCT 24, 2011 
              HELP-PROMPT:      Select Queue. 
              DESCRIPTION:
                                This is the queue in which the message is placed.  

              TECHNICAL DESCR:
                                Added in patch MAG*3.0*34 

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

              RECORD INDEXES:   ENQBLDT (#1112), ENQDT (#1113), ENQPLDT (#1114)

2006.928,2    PRIORITY               0;2 NUMBER (Required)

              INPUT TRANSFORM:  K:+X'=X!(X>99)!(X<1)!(X?.E1"."1.N) X
              LAST EDITED:      OCT 26, 2011 
              HELP-PROMPT:      Type a number between 1 and 99, 0 decimal digits. 
              DESCRIPTION:      An ordinal number indicating the priority of this message. Higher priority messages will be fetched
                                from the queue and processed ahead of lower priority messages. 1 indicates highest priority and 99
                                the lowest priority.  

              TECHNICAL DESCR:
                                Added in patch MAG*3.0*34 


2006.928,3    ENQUEUED DATE/TIME     0;3 DATE (Required)

              INPUT TRANSFORM:  S %DT="ESTR" D ^%DT S X=Y K:Y<1 X
              LAST EDITED:      SEP 14, 2011 
              HELP-PROMPT:      Date and time the message was placed on queue. 
              DESCRIPTION:
                                Date and time at which the message was placed in the queue.  

              TECHNICAL DESCR:
                                Added in patch MAG*3.0*34 

              RECORD INDEXES:   ENQBLDT (#1112), ENQDT (#1113), ENQPLDT (#1114)

2006.928,4    EARLIEST DELIVERY DATE/TIME 0;4 DATE

              INPUT TRANSFORM:  S %DT="ESTR" D ^%DT S X=Y K:X<1 X
              LAST EDITED:      NOV 01, 2011 
              HELP-PROMPT:      Enter date and time of earliest delivery. 
              DESCRIPTION:      Date and time that must be reached before the message is eligible to be retrieved from the queue
                                for processing.  

              TECHNICAL DESCR:
                                Added in patch MAG*3.0*34 


2006.928,5    EXPIRATION DATE/TIME   0;5 DATE

              INPUT TRANSFORM:  S %DT="ESTR" D ^%DT S X=Y K:Y<1 X
              LAST EDITED:      SEP 14, 2011 
              HELP-PROMPT:      Enter date and time of expiration. Blank means never expires.  
              DESCRIPTION:      Date and time after which the message is no longer valid or eligible for processing. An empty value
                                here implies that the message never expires.  

              TECHNICAL DESCR:
                                Added in patch MAG*3.0*34 


2006.928,6    MESSAGE                1;0   WORD-PROCESSING #2006.9286   (IGNORE "|")

              TECHNICAL DESCR:
                                Added in patch MAG*3.0*34 


                LAST EDITED:      NOV 01, 2011 
                HELP-PROMPT:      Enter queue message. 
                DESCRIPTION:
                                  The content of the queue message.  

                TECHNICAL DESCR:
                                  Added in patch MAG*3.0*34 




2006.928,7    MESSAGE GROUP ID       0;7 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>30!($L(X)<1) X
              LAST EDITED:      OCT 26, 2011 
              HELP-PROMPT:      Answer must be 1-30 characters in length. 
              DESCRIPTION:      The value in the field MESSAGE GROUP ID indicates a subgroup within a queue. For example, the
                                hostname of a DICOM Gateway. The field allows messages to be filtered by QUEUE and MESSAGE GROUP
                                ID. This is useful when messages from a queue with the same MESSAGE GROUP ID must be processed 
                                together by the same processing agent. For example, messages in the email queue originating from
                                the same DICOM Gateway host.  

              TECHNICAL DESCR:
                                Added in patch MAG*3.0*34 

              RECORD INDEXES:   ENQBLDT (#1112), ENQPLDT (#1114)


      FILES POINTED TO                      FIELDS

QUEUE (#2006.927)                 QUEUE (#.01)


File #2006.928

  Record Indexes:

  ENQBLDT (#1112)    RECORD    REGULAR    IR    LOOKUP & SORTING
      Short Descr:  Index on queue ID and queued date/time and place is blank.
        Set Logic:  S ^MAGV(2006.928,"ENQBLDT",X(1),X(2),DA)=""
         Set Cond:  S X=(X(3)="")
       Kill Logic:  K ^MAGV(2006.928,"ENQBLDT",X(1),X(2),DA)
       Whole Kill:  K ^MAGV(2006.928,"ENQBLDT")
             X(1):  QUEUE  (2006.928,.01)  (Subscr 1)  (forwards)
             X(2):  ENQUEUED DATE/TIME  (2006.928,3)  (Subscr 2)  (forwards)
             X(3):  MESSAGE GROUP ID  (2006.928,7)  (forwards)

  ENQDT (#1113)    RECORD    REGULAR    IR    LOOKUP & SORTING
      Short Descr:  We use to find messages by QUEUE IEN and oldest date
        Set Logic:  S ^MAGV(2006.928,"ENQDT",X(1),X(2),DA)=""
       Kill Logic:  K ^MAGV(2006.928,"ENQDT",X(1),X(2),DA)
       Whole Kill:  K ^MAGV(2006.928,"ENQDT")
             X(1):  QUEUE  (2006.928,.01)  (Subscr 1)  (forwards)
             X(2):  ENQUEUED DATE/TIME  (2006.928,3)  (Subscr 2)  (forwards)

  ENQPLDT (#1114)    RECORD    REGULAR    IR    LOOKUP & SORTING
      Short Descr:  This index is used to find entries by Queue, Place and Date
        Set Logic:  S ^MAGV(2006.928,"ENQPLDT",X(1),X(2),X(3),DA)=""
       Kill Logic:  K ^MAGV(2006.928,"ENQPLDT",X(1),X(2),X(3),DA)
       Whole Kill:  K ^MAGV(2006.928,"ENQPLDT")
             X(1):  QUEUE  (2006.928,.01)  (Subscr 1)  (forwards)
             X(2):  MESSAGE GROUP ID  (2006.928,7)  (Subscr 2)  (forwards)
             X(3):  ENQUEUED DATE/TIME  (2006.928,3)  (Subscr 3)  (forwards)


INPUT TEMPLATE(S):

PRINT TEMPLATE(S):

SORT TEMPLATE(S):
MAGVA-ASYNC-STORAGE-ERRORS    MAY 09, 2012@13:24  USER #0                   'MAGVA-ASYNC-STORAGE-ERRORS' Print Template always used  
                                                       QUEUE EQUALS 2^Async Storage Request Error Queue
     Stores Asynchronous Storage Request Error Queue entries from
     the QUEUE MESSAGE file. (MAG*3.0*116)


FORM(S)/BLOCK(S):