STANDARD DATA DICTIONARY #2006.69 -- MAG VISTARAD SITE PARAMETERS FILE                                            3/24/25    PAGE 1
STORED IN ^MAG(2006.69,  *** 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 contains various site-specific parameters that control the behavior of VistaRad.  


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

   APPLICATION GROUP(S): MAGJ

CROSS
REFERENCED BY: VISTARAD SITE NAME(B), RECENT EXAMS DAYS LIMIT(RECENT), UNREAD EXAMS DAYS LIMIT(UNREAD)

    LAST MODIFIED: DEC 18,2023@14:48:14

2006.69,.01   VISTARAD SITE NAME     0;1 FREE TEXT (Required)

              INPUT TRANSFORM:  K:$L(X)>30!($L(X)<3) X S DINUM=1
              LAST EDITED:      SEP 24, 1997 
              HELP-PROMPT:      Enter Name of your site, 3 to 30 characters. 
              DESCRIPTION:
                                Field contains the name of the site.  

              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER

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


2006.69,.05   ENABLE STATUS UPDATE?  0;4 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      SEP 17, 1998 
              HELP-PROMPT:      Enter YES to enable VistaRad to update the Radiology Package Exam Status field 
              DESCRIPTION:      Answering this question "YES" will enable VistaRad to update the Radiology Package Interpreting
                                Radiologist fields (#12 & #15), and the Exam Status field (#3).  Otherwise, use of VistaRad
                                provides read-only access to VISTA data.  


2006.69,1     RECENT EXAMS DAYS LIMIT 0;2 NUMBER

              INPUT TRANSFORM:  K:+X'=X!(X>99999)!(X<2)!(X?.E1"."1N.N) X
              LAST EDITED:      MAR 13, 2002 
              HELP-PROMPT:      Type a Number between 2 and 99999, 0 Decimal Digits 
              DESCRIPTION:      The RECENT Exams list shows all exams having a Status of Interpreted or Transcribed.  The list can
                                be further restricted to show only exams up to 'N' days old--use this field to define a value for
                                'N'.  Note that for most sites, Exams are likely to be marked Complete within 3 to 4 working days
                                of being Interpreted, at which point they no longer show up on the RECENT Exams list.  If NOT
                                defined, the system defaults to  a value of 6.  

              CROSS-REFERENCE:  2006.69^RECENT^MUMPS 
                                1)= S ^MAG(2006.69,"RECENT")=X
                                2)= K ^MAG(2006.69,"RECENT")


2006.69,2     UNREAD EXAMS DAYS LIMIT 0;3 NUMBER

              INPUT TRANSFORM:  K:+X'=X!(X>99999)!(X<2)!(X?.E1"."1N.N) X
              LAST EDITED:      MAR 13, 2002 
              HELP-PROMPT:      The Unread Exams list will not display exams older than the number of days you specify. 
              DESCRIPTION:      The UNREAD Exams list shows all exams having a Status of EXAMINED.  The list can be further
                                restricted to show only exams up to 'N' days old--use this field to define a value for 'N'.  If NOT
                                defined, the system defaults to a value of 30.  

              CROSS-REFERENCE:  2006.69^UNREAD^MUMPS 
                                1)= S ^MAG(2006.69,"UNREAD")=X
                                2)= K ^MAG(2006.69,"UNREAD")


2006.69,3     PREFETCH ACTIVE?       0;5 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      AUG 21, 1998 
              HELP-PROMPT:      To Enable Prefetch of prior exams' images from archive, enter YES. 
              DESCRIPTION:      Exam images that have been archived, e.g. to jukebox storage, may be retrieved to magnetic disk at
                                the time a new exam is registered for a patient.  Enabling this allows immediate retrieval of the
                                patient's prior exams when the radiologist is ready to read the new exam.  


2006.69,5     LIST ONLY EXAMS HAVING IMAGES? 0;7 SET

                                '0' FOR NO; 
                                '1' FOR YES; 
              LAST EDITED:      AUG 25, 1998 
              HELP-PROMPT:      Enter 'NO' to list ALL exams, 'YES' to list only exams that have images.    This applies only to 
                                UNREAD, ACTIVE, PENDING, and ALL EXAMS lists. 
              DESCRIPTION:      Some sites may have a mix of exams that do, and do not, have images stored digitally.  In this
                                case, the UNREAD, ACTIVE and PENDING exams lists may be optionally configured to either list only
                                the exams that have images available for display on the VistaRad workstation, or to list all exams, 
                                including those that do not have images available for display.  NOTE that the Patient Exams List
                                always lists ALL exams, regardless of whether images exist or not.  


2006.69,6     BACKGROUND COMPILE EXAM LISTS? 0;8 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      FEB 23, 2000 
              HELP-PROMPT:      To compile Exam Lists in the background, enter desired value. 
              DESCRIPTION:      The process of compiling UNREAD & RECENT exam lists from the radiology database may be relatively
                                lengthy.  To enable these lists to reach the radiology workstation rapidly, they can be compiled
                                periodically in the background on the Vista system.  Enabling this option generally should provide
                                for very fast retrieval of the exam lists.  Note, however, that on the UNREAD Exams list the most
                                recently completed ("EXAMINED") exams may not appear on the list, up to a time limit defined below;
                                however, exams that are "INTERPRETED" will be dropped from the UNREAD list, even in between
                                compiles.  UNREAD compiles are automatically started by requesting an UNREAD Exams list at the
                                workstation.  The background program is initiated via an internal TaskMan call, but it will run
                                continuously in the background after being initiated. The RECENT compile is initiated using the
                                TaskMan Scheduled Options capability.  The Option to schedule is MAGJ SCHED RECENT LIST COMPILE; it
                                is recommended that this process be scheduled to run every 30 to 90 minutes.  


2006.69,7     UNREAD BKGND COMPILE INTERVAL 0;9 NUMBER

              BACKGROUND COMPILE INTERVAL--UNREAD LIST   
              INPUT TRANSFORM:  K:+X'=X!(X>15)!(X<2)!(X?.E1"."1N.N) X
              LAST EDITED:      MAR 07, 2000 
              HELP-PROMPT:      Type a Number between 2 and 15, 0 Decimal Digits 
              DESCRIPTION:      If compiling exams lists in the background, this field is used to define the number of minutes to
                                wait in between each successive compile of the UNREAD Exams List.  If not specified, the default
                                value used will be 6 minutes.  For sites that tend to have more than 100 Unread exams on average,
                                it is recommended to use a value of 3 or 4 minutes; less than 100, use 2 or 3 minutes.  


2006.69,7.2   RECENT BKGND COMPILE INTERVAL 0;13 NUMBER

              INPUT TRANSFORM:  K:+X'=X!(X>240)!(X<30)!(X?.E1"."1N.N) X
              LAST EDITED:      APR 05, 2000 
              HELP-PROMPT:      Type a Number between 30 and 240, 0 Decimal Digits 
              DESCRIPTION:      The Recent List Background Compile is managed by Taskman, where a Scheduled Option should be
                                defined for periodically compiling this list (recommended to compile every two to three hours). 
                                Use this field to let VistARad know what you have defined in TaskMan as the interval between 
                                compiles.  This value is used to provide a warning message to the VistaRad user should it appear
                                that the Background Compile has not run for more than this expected interval of time.  Obviously,
                                this field only is useful if BACKGROUND COMPILE EXAM LISTS has been Enabled.  


2006.69,8     REMOTE LIST ONLY REMOTE CACHE? 0;10 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      DEC 22, 1998 
              HELP-PROMPT:      Enter 'NO' to list ALL exams, 'YES' to list only exams that were routed to the remote site. 
              DESCRIPTION:      This question only applies to sites that use the Imaging Routing Gateway to route images to a
                                remote facility for reading.  
                                 
                                At the remote reading workstation, the Unread & Recent Exams lists may display either all exams, or
                                only the subset of the exams that have been routed to the remote site. Enter YES to display only
                                the routed exams.  


2006.69,9     SITE SENDS TO REMOTE CACHE 0;11 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      MAR 19, 1999 
              HELP-PROMPT:      Enter YES if this site routes images to remote locations. 
              DESCRIPTION:      This question only applies to sites that use the Imaging Routing Gateway to route images to a
                                remote facility for reading.  
                                 
                                Answering this question YES turns on extra processing that is needed to manage the remote exams
                                properly in VistARad.  


2006.69,12    REQUISITION FOR RAD STAFF ONLY 0;16 SET

                                '1' FOR Y; 
              LAST EDITED:      FEB 17, 2005 
              HELP-PROMPT:      Enter YES to restrict access to the Requisition report. 
              DESCRIPTION:      Setting this value to YES will prevent non-radiology personnel from viewing the Radiology
                                Requisition from Vistarad.  Some sites have data that appears on the requisition which is strictly
                                for internal radiology staff use.  This prompt provides a way to restrict access to that report.  


2006.69,13    ENA DICT PREF-YES ALL LOCKED 0;17 SET

              ENABLE DICTATION PREFERENCE--YES FOR ALL LOCKED EXAMS   
                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      APR 08, 2009 
              HELP-PROMPT:      This sets a site policy for enabling a user preference for the dictation interface.  Enter ?? for a 
                                detailed explanation. 
              DESCRIPTION:      This setting affects some behavior of VistARad's dictation system interface.  When a locked exam is
                                opened, the accession number is sent across the interface via the Dictation dialog.  Normally,
                                whenever more than one locked exam is opened, the dialog displays an entry for each of the exams,
                                and defaults YES (i.e. send the accession number across) for only one of the exams; the user may
                                manually change the selection for any or all of the exams to YES if desired.  
                                  
                                A user preference exists to allow the user to specify that ALL locked exams in this dialog be
                                defaulted to YES.  This preference is only enabled if a site-level policy is implemented to allow
                                the use of this preference.  Answering YES to the setting ENA DICT PREF-YES ALL LOCKED implements
                                this site-level policy.  Each user then may choose to enable the preference--the system's default
                                behavior is to disable this preference.  


2006.69,20    UNREAD LIST PRIORITY SEQ 1;E1,245 FREE TEXT

              INPUT TRANSFORM:  S X=$TR(X,"supr;. ","SUPR,,") K:'((X?1U1","1U1","1U1","1U)&($F(X,"R")&$F(X,"S")&$F(X,"P")&$F(X,"U")
                                )) X
              LAST EDITED:      FEB 22, 1999 
              HELP-PROMPT:      Answer must be 7 characters in length, using the letters S, U, P & R; enter ?? for more help. 
              DESCRIPTION:      The Unread lists show a column, PRIORITY, that is typically used as a sort item for the list.  Four
                                values are possible (from the Radiology Exam order, file 75.1).  This field allows the site to
                                define the preferred sort ordering for these 4 values.  The default order is: 
                                   Stat, Urgent, Pre-op, Routine To achieve this ordering, the value for this field would be
                                specified: 
                                   S,U,P,R Any sequence of these 4 letters may be defined, and then will be used by the list
                                program.  

              WRITE AUTHORITY:  @

2006.69,101   ENABLE ASSIGN EXAMS FEATURE? ISI;1 SET

                                'Y' FOR YES; 
                                'N' FOR NO; 
              LAST EDITED:      OCT 19, 2022 
              HELP-PROMPT:      Enter "??" for more information. 
              DESCRIPTION:      This feature allows an exam to be assigned to a specific Radiologist, or Radiology Tech, for
                                interpretation or follow-up.  This feature works only if ISI's "Rad Tech Tool" has been installed 
                                and configured at the site.  


2006.69,102   ENABLE DYNAMIC QUERY FEATURE? ISI;2 SET

                                'Y' FOR YES; 
                                'N' FOR NO; 
              LAST EDITED:      JUN 28, 2018 
              HELP-PROMPT:      Enter YES to enable the Dynamic Query feature. 
              DESCRIPTION:      The Dynamic Query feature, and all supporting program logic and functionality, shall be enabled
                                only if this field has a value = "Y".  


2006.69,103   DYNAMIC QUERY RECORD LIMIT ISI;3 NUMBER

              INPUT TRANSFORM:  K:+X'=X!(X>15000)!(X<0)!(X?.E1"."1N.N) X
              LAST EDITED:      MAY 21, 2019 
              HELP-PROMPT:      Type a number between 0 and 15000, 0 decimal digits. 
              DESCRIPTION:      To prevent dynamic query compiles processing very large result sets, this value may be defined to
                                abort a query that exceeds the number specified here.  


2006.69,104   ENABLE EXAM LIST STATISTICS? ISI;4 SET

                                'Y' FOR Yes; 
                                'N' FOR No; 
              LAST EDITED:      MAY 21, 2019 
              HELP-PROMPT:      Enter Yes to enable collecting Exam Lists usage statistics. 
              DESCRIPTION:      If enabled, this feature counts the frequency of use of each of the exam lists.  The data is
                                aggregated weekly by site.  These statistics may be viewed by using the PRINT EXAM LIST STATISTICS
                                menu option.  


2006.69,105   ENABLE MANAGER REV-2   ISI;5 SET

                                '0' FOR No; 
                                '1' FOR Yes, Level-1; 
                                '2' FOR Yes, Level-2; 
              LAST EDITED:      JUL 09, 2019 
              HELP-PROMPT:      Enter 1 or 2 to enable the Manager Revision-2 system modifications. 
              DESCRIPTION:      The Revision-2 modifications remove two obsolete exam lists from the Manager's top tab row; in
                                their place the Assigned-UNREAD and Assigned-WAITING tab entries are inserted ("Level-1"). 
                                "Level-2" also removes the Background compile of RECENT exams from server-side processing, so the
                                option "MAGJ SCHED RECENT LIST COMPILE" no longer needs to be defined in Taskman.  The obsolete
                                exam lists are "Recent", and "All Active Exams"; these are still accessible on the Custom tab, if
                                desired.  


2006.69,106   DYNAMIC QUERY DAYS LIMIT ISI;6 NUMBER

              INPUT TRANSFORM:  K:+X'=X!(X>11000)!(X<1)!(X?.E1"."1N.N) X
              LAST EDITED:      OCT 19, 2022 
              HELP-PROMPT:      Type a number between 1 and 11000, 0 decimal digits. 
              DESCRIPTION:      Enter a value to limit how many days back the dynamic query compile may go.  This will prevent the
                                user from entering a Study From Date value earlier than "Today" minus the value you enter here.  


2006.69,107   READY FOR INTERP IMAGING TYPE ISI;7 POINTER TO IMAGING TYPE FILE (#79.2)

              LAST EDITED:      SEP 08, 2021 
              HELP-PROMPT:      Enter '??' for detailed explanation. 
              DESCRIPTION:      In the typical Radiology workflow, dictation/report entry occurs for exams after images have been
                                acquired.  In some circumstances it is desirable to initiate a report entry session PRIOR to image
                                acquisition.  Ultrasound workflow is the notable example for this.  To support this, a reserved
                                EXAMINATION STATUS value must be defined, having a specific VISTARAD CATEGORY value, "Ready for
                                Interpretation",  that is defined to enable this alternate workflow. This Examination Status value
                                must have an ORDER that sequences it between the WAITING FOR EXAM status and the EXAMINED status.
                                Enter the IMAGING TYPE value for which you want to enable this feature. This must align with the
                                IMAGING TYPE for which the Examination Status value is being defined.  


2006.69,108   READY FOR INTERP TRIGGER VALUE ISI;8VARIABLE POINTER

              FILE  ORDER  PREFIX    LAYGO  MESSAGE
                 78.6 1    CAM          n   Enter value=Ready for Interp 
                                         
              LAST EDITED:      JUL 21, 2021 
              HELP-PROMPT:      Enter value that will trigger the "Ready for Interpretation" Status Code 
              DESCRIPTION:      A reserved value defined in the CAMERA/EQUIP/RM file should be defined for triggering the Exam
                                Status to advance from the WAITING FOR EXAM status to the status defined having the VISTARAD
                                CATEGORY value, "Ready for Interpretation".  Enter the reserved CAMERA/EQUIP/RM value here.  


2006.69,109   ENABLE NOTES FEATURE?  ISI;9 SET

                                '1' FOR YES; 
                                '0' FOR NO; 
              LAST EDITED:      OCT 31, 2022 
              HELP-PROMPT:      Enter YES to enable the NOTES feature. 
              DESCRIPTION:      This feature allows any ISI Rad user to enter and/or view notes related to the exam.  These notes
                                are displayed within the ISI Rad application only, appended to either the exam Report or
                                Requisition.  


2006.69,110   ENABLE ISIRad DICTATION OPTION ISI;10 SET

                                '1' FOR Yes; 
                                '0' FOR No; 
              LAST EDITED:      OCT 18, 2022 
              HELP-PROMPT:      Answer YES to allow the ISI Rad Dictation option to appear on the ISI Rad Settings/Dictation form. 
              DESCRIPTION:      This option allows the user to select the "ISI Rad" Dictation setting, which provides the user a
                                way to manually enter Radiology reports in a ISI Rad data entry form.  The reports are stored using
                                the Radiology HL7 interface.  This option works only if the requisite Radiology package programs
                                and HL7 configurations have been installed and configured at the site.  



      FILES POINTED TO                      FIELDS

CAMERA/EQUIP/RM (#78.6)           READY FOR INTERP TRIGGER VALUE (#108)

IMAGING TYPE (#79.2)              READY FOR INTERP IMAGING TYPE (#107)



INPUT TEMPLATE(S):

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):