DG FIELD MONITOR ICR (3344)

Name

Value

NUMBER

3344

IA #

3344

DATE CREATED

2001/03/28

CUSTODIAL PACKAGE

REGISTRATION

USAGE

Controlled Subscription

TYPE

Other

DBIC APPROVAL STATUS

APPROVED

NAME

DG FIELD MONITOR

GENERAL DESCRIPTION


This protocol is an event point which monitors the editing of
fields in DG* application files.  At the time of this event point, the
following variables will be present in the environment:

Variable   Description
--------   -----------------------------------------------
DGDA       DA array as exists during Fileman editing
DGFILE     File or subfile number where changed field resides
DGFIELD    Number of changed field
DGTYPE     Type of cross reference action (ADD, DELETE or UPDATE)
DGDTH      Date/time of change in $Horolog format
DGUSER     DUZ of user that made the change
DGOPT      Current menu option in "option_name^menu_text" format
DGX        X array as documented for Fileman new style x-refs
DGX1       X1 array as documented for Fileman new style x-refs
DGX2       X2 array as documented for Fileman new style x-refs

This protocol is triggered by "listener" cross references on selected
fields.  By employing logic such as "If DGFILE=2, DGFIELD=.361,
DGTYPE="SET", then...", subscribers to this protocol may take action
based on edit activity which involves those fields.

This event point is designed to occur only once per field editing
activity. The DGTYPE variable can be interpreted as follows:

o  ADD transactions indicate that data has been added to a field
that was previously null.  The DGX, DGX1 and DGX2 arrays will
contain the Fileman X, X1 and X2 arrays (respectively) as
documented for the execution of 'SET' logic.

o  DELETE transactions indicate that previously existing data has
been deleted without being replaced.  The DGX, DGX1 and DGX2
arrays will contain the Fileman X, X1 and X2 arrays
(respectively) as documented for the execution of 'KILL' logic.

o  UPDATE transactions indicate that existing data has been
deleted and new data has been filed.  The DGX, DGX1 and DGX2
arrays will contain the Fileman X, X1 and X2 arrays
(respectively) as documented for the execution of 'SET' logic.

STATUS

Active

KEYWORDS

Monitor
Listener
DG

DURATION

Till Otherwise Agreed

SUBSCRIBING PACKAGE

SUBSCRIBING PACKAGE	SUBSCRIBING DETAILS
SPINAL CORD DYSFUNCTION	The subscribing protocols are: SPN REG STATUS DELETE Notice of Date of Death Deletion SPN REG STATUS UPDATE Update Registration Status to Expired
SCHEDULING	The subscribing protocol is: SCMC PCMM INACTIVATE ON DATE OF DEATH
FEE BASIS	The subscribing protocol is: FB PATIENT DATA CHANGE
PHARMACY BENEFITS MANAGEMENT	The subscribing protocol is: PSU PATIENT DEMOGRAPHIC CHANGE
VIRTUAL PATIENT RECORD	Added VPR DG UPDATES protocol to event point. The VPR protocol listeners will store the patient's DFN in an ^XTMP array; another process within HMP watches this global for patients to update and will re-pull a snapshot of the patient's demographics.
HEALTH MANAGEMENT PLATFORM	************************************************************************** HMP's subscription to this ICR expired on 10/27/17 with the shutdown of HMP. HMP2.012 released on 10/17/17 is an informational patch outlining the steps for the sites to shut down the application. If HMP is reactivated in the future, the HMP project team should review the access provided by this ICR with the custodial application before reactivating HMP's subscription to this ICR. ************************************************************************** HMP DG UPDATES protocol has been added to the DG FIELD MONITOR protocol by HMP v.2.0 to trigger unsolicited patient updates from VistA to JDS when fields monitored by this protocol are updated.