STANDARD DATA DICTIONARY #560 -- VPR SUBSCRIPTION FILE                                                            6/27/25    PAGE 1
STORED IN ^VPR(  (1 ENTRY)   SITE: WWW.BMIRWIN.COM   UCI: VISTA,VISTA                                              (VERSION 1.0)   

DATA          NAME                  GLOBAL        DATA
ELEMENT       TITLE                 LOCATION      TYPE
-----------------------------------------------------------------------------------------------------------------------------------
The VPR SUBSCRIPTION (#560) file contains parameters needed for tracking patient data changes on this VistA system, for updating
the Regional Health Connect servers. A dynamic index informs the RHC of records that have been updated for a patient. Monitoring
can also be turned off here if necessary.  


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

CROSS
REFERENCED BY: SITE NAME(B)

INDEXED BY:    PATIENT NAME (ANEW), PATIENT NAME (AVPR)


    LAST MODIFIED: APR 20,2021@15:04:42

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

              INPUT TRANSFORM:  K:$L(X)>30!($L(X)<3)!'(X'?1P.E) X S DINUM=1
              LAST EDITED:      OCT 16, 2018 
              HELP-PROMPT:      Answer must be 3-30 characters in length. 
              DESCRIPTION:
                                Enter a name for this system.  

              TECHNICAL DESCR:
                                There can be only one entry in this file.  

              DELETE TEST:      1,0)= I 1

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

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


560,.02       ENABLE MONITORING      0;2 SET (BOOLEAN Data Type)

              LAST EDITED:      OCT 16, 2018 
              HELP-PROMPT:      Select YES to begin tracking patient data changes for the Regional Health Connect server. 
              DESCRIPTION:
                                Select YES to track the record numbers of patient data that is modified in the AVPR index.  

              TECHNICAL DESCR:  Do NOT change this value from YES to NO unless directed to do so by Health Product Support or
                                development staff, as the data cache on the Regional Health Connect server will become out of synch
                                with VistA.  


560,.03       DATE DISABLED          0;3 DATE

              INPUT TRANSFORM:  S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
              LAST EDITED:      JUL 31, 2020 
              HELP-PROMPT:      Enter the date/time that data monitoring was stopped. 
              DESCRIPTION:      This value is stuffed in automatically by the VPR HS ENABLE option when the ENABLE MONITORING FIELD
                                (#.02) is changed to NO.  


560,.04       DATE ENABLED           0;4 DATE

              INPUT TRANSFORM:  S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
              LAST EDITED:      JUL 31, 2020 
              HELP-PROMPT:      Enter the date/time that data monitoring was re-started. 
              DESCRIPTION:      This value is stuffed in automatically by the VPR HS ENABLE option when the ENABLE MONITORING FIELD
                                (#.02) is changed to YES.  


560,.05       ENABLE LOGGING         0;5 SET (BOOLEAN Data Type)

              LAST EDITED:      FEB 12, 2021 
              HELP-PROMPT:      Enter YES to turn on logging of the update list for debugging. 
              DESCRIPTION:      If this field is set to YES, then every AVPR and ANEW entry created to notify HealthShare will be
                                stored in ^XTMP("VPRHS",seq,dfn)=data string.  


560,1         LAST NUMBER            1;1 NUMBER

              INPUT TRANSFORM:  K:+X'=X!(X>999999999)!(X<1)!(X?.E1"."1N.N) X
              LAST EDITED:      OCT 16, 2018 
              HELP-PROMPT:      Type a number between 1 and 999999999, 0 decimal digits. 
              DESCRIPTION:
                                This is the last sequence number used in the AVPR index.  

              TECHNICAL DESCR:
                                This value is managed by routine VPRHS, and should NOT be edited via FileMan options.  


560,2         PATIENTS               2;0 POINTER Multiple #560.02 (Add New Entry without Asking)

              DESCRIPTION:      This is the list of patients on this system who are being monitored for changes, which will be
                                retrieved by the Regional Health Connect.  


560.02,.01      PATIENT NAME           0;1 POINTER TO PATIENT FILE (#2) (Multiply asked)

                INPUT TRANSFORM:  S DINUM=+X
                LAST EDITED:      NOV 16, 2018 
                HELP-PROMPT:      Enter the name of a patient for whom data updates are to be tracked. 
                DESCRIPTION:
                                  This is a patient whose data is being tracked for the Regional Health Connect server.  

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

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

                FIELD INDEX:      ANEW (#1538)    MUMPS        ACTION    WHOLE FILE (#560)
                    Short Descr:  Mark New Patients for Regional Health Connect
                    Description:  This cross reference is used to notify the Regional Health Connect that a new patient needs to be
                                  added to the repository. Changes to patient information are monitored by VPR listeners attached
                                  to cross references and Protocol file events; when there is activity on a patient not in the 
                                  repository, the following node will be set by routine NEW^VPRHS: 
                                   
                                    ^VPR("ANEW",seq#,DFN)=ICN 
                                   
                                  This node is monitored by the Regional Health Connect and will be deleted after it has been
                                  processed.  
                      Set Logic:  Q
                     Kill Logic:  Q
                           X(1):  Computed Code: S X=+$G(^VPR(DA(1),1))
                                    (Subscr 1)  (Len 15)  (forwards)
                           X(2):  PATIENT NAME  (560.02,.01)  (Subscr 2)  (Len 15)  (forwards)
         NO RE-INDEXING ALLOWED!

                FIELD INDEX:      AVPR (#1539)    MUMPS        ACTION    WHOLE FILE (#560)
                    Short Descr:  Mark Patients for Regional Health Connect
                    Description:  This cross reference is used to notify the Regional Health Connect that the given patient
                                  information has been added to or modified. Changes to patient information are monitored by VPR
                                  listeners attached to cross references and Protocol file events; when data has changed, the
                                  following node will be set by routine POST^VPRHS:                    
                                     
                                    ^VPR("AVPR",seq#,DFN)=ICN^TYPE^ID^ACTION^VISIT# 
                                     
                                  This node is monitored by the Regional Health Connect and will be deleted after it has been
                                  processed.  
                      Set Logic:  Q
                     Kill Logic:  Q
                           X(1):  Computed Code: S X=+$G(^VPR(DA(1),1))
                                    (Subscr 1)  (Len 15)  (forwards)
                           X(2):  PATIENT NAME  (560.02,.01)  (Subscr 2)  (Len 15)  (forwards)
         NO RE-INDEXING ALLOWED!


560.02,.02      TASK                   0;2 FREE TEXT

                INPUT TRANSFORM:  K:$L(X)>20!($L(X)<1) X
                MAXIMUM LENGTH:   20
                LAST EDITED:      JAN 03, 2019 
                HELP-PROMPT:      Answer must be 1-20 characters in length. 
                DESCRIPTION:      This is the task number for the background job that is queued to update the HealthShare Patient
                                  container; it will be deleted when the task completes.  





      FILES POINTED TO                      FIELDS

PATIENT (#2)                      PATIENTS:PATIENT NAME (#.01)



INPUT TEMPLATE(S):

PRINT TEMPLATE(S):

SORT TEMPLATE(S):

FORM(S)/BLOCK(S):