STANDARD DATA DICTIONARY #776.2 -- HL7 MONITOR MASTER JOB FILE 6/27/25 PAGE 1
STORED IN ^HLEV(776.2, (48 ENTRIES) SITE: WWW.BMIRWIN.COM UCI: VISTA,VISTA (VERSION 1.6)
DATA NAME GLOBAL DATA
ELEMENT TITLE LOCATION TYPE
-----------------------------------------------------------------------------------------------------------------------------------
DD ACCESS: @
RD ACCESS: @
WR ACCESS: @
DEL ACCESS: @
LAYGO ACCESS: @
AUDIT ACCESS: @
POINTED TO BY: MASTER JOB PTR field (#9) of the HL7 MONITOR JOB File (#776)
CROSS
REFERENCED BY: CREATION TIME(B)
776.2,.01 CREATION TIME 0;1 DATE (Required)
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: JUN 01, 2003
DESCRIPTION: This field holds the time when the entry in this file was created (at the beginning of the running
of the background master job.)
CROSS-REFERENCE: 776.2^B
1)= S ^HLEV(776.2,"B",$E(X,1,30),DA)=""
2)= K ^HLEV(776.2,"B",$E(X,1,30),DA)
On a parameter-controlled frequency, a master job is run to determine whether individual monitors
should be run. When these master jobs start, an entry is made in the HL Event Master Job file
(#776.2). The .01 field of this file is Creation Time, and this B xref is created based on the
date/time value in this field.
776.2,2 COMPLETION TIME 0;2 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAY 18, 2003
DESCRIPTION:
This field holds the time when the master job completed.
776.2,3 TIMESTAMP 0;3 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAY 18, 2003
DESCRIPTION: Periodically, when the master job is running, this timestamp is refreshed. Normally, this
timestamp will be equal to the completion time of the master job.
776.2,4 STATUS 0;4 SET
'E' FOR ERRORED;
'F' FOR FINISHED;
'Q' FOR QUEUED;
'R' FOR RUNNING;
'P' FOR PARAMETER STOP;
'S' FOR STOP REQUESTED;
'A' FOR ABORTED-NOT RUN;
LAST EDITED: JUN 01, 2003
DESCRIPTION:
This field holds the status of the master job.
776.2,5 TASK NUMBER 0;5 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>999999999999)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: MAY 18, 2003
HELP-PROMPT: Type a Number between 1 and 999999999999, 0 Decimal Digits
DESCRIPTION:
This field holds the task number for the background master job.
776.2,6 QUEUE TIME 0;6 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAY 18, 2003
DESCRIPTION: When the master job starts, as it's first action, it queues the next master job for a future time
REQUEUE MINUTES in the future. At that time, an entry is made in this file and the "future time"
recorded in this field.
776.2,7 QUEUE PERSON 0;7 POINTER TO NEW PERSON FILE (#200)
LAST EDITED: MAY 21, 2003
DESCRIPTION: This field holds the DUZ of the person who started the master job the first time. (From that time
on, that person's DUZ will remain associated with all future master jobs.)
776.2,8 START TIME 0;8 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: JUN 01, 2003
DESCRIPTION: Master jobs are queued to a future time. When these jobs activate, the time "now" is recorded in
this field.
776.2,50 RUN DIARY 50;0 WORD-PROCESSING #776.201 (NOWRAP)
DESCRIPTION: This field holds information about the master job process, and cannot be modified by non-VistA HL7
applications.
LAST EDITED: MAY 18, 2003
776.2,51 EVENTS CHECKED 51;0 Multiple #776.2051 (Add New Entry without Asking)
DESCRIPTION: When the master job runs, it checks all existing event monitors in the HL Event Monitor file
(#776.1). One entry in this Events Checked multiple is made for every monitor found. (See the
fields in this multiple for additional information.)
776.2051,.01 EVENT MONITOR IEN (Free-Text) 0;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>12!($L(X)<1) X
LAST EDITED: MAY 23, 2003
HELP-PROMPT: Answer must be 1-12 characters in length.
DESCRIPTION: This field holds the internal entry number of the monitor entry in the HL Event Monitor file
(#776.1).
NOTE: This is a free-text field, and not a pointer field! This was done to ensure that monitors
could be deleted without creating broken pointers.
CROSS-REFERENCE: 776.2051^B
1)= S ^HLEV(776.2,DA(1),51,"B",$E(X,1,30),DA)=""
2)= K ^HLEV(776.2,DA(1),51,"B",$E(X,1,30),DA)
776.2051,2 ACTION 0;2 SET
'E' FOR TOO EARLY;
'I' FOR INACTIVE;
'Q' FOR QD NEW JOB;
'X' FOR ERROR;
'R' FOR RUNNING;
'M' FOR M CHK FAIL;
LAST EDITED: AUG 07, 2003
DESCRIPTION: When a monitor is checked, the master job either starts a background job for the monitor, or it
doesn't. If it does, record is made of the fact in this field. If a monitor job is not started,
the reason is also recorded in this field. (The Results field (#5) often holds additional
information about the action taken by the master job for a specific monitor.)
776.2051,3 CHECK/QUEUE TIME 0;3 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAY 21, 2003
DESCRIPTION:
This field holds the time the master job checked the monitor.
776.2051,4 TASK NUMBER 0;4 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>99999999999999)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: MAY 21, 2003
HELP-PROMPT: Type a Number between 1 and 99999999999999, 0 Decimal Digits
DESCRIPTION:
This field holds the task number of the queued monitor job created by the master job.
776.2051,5 RESULTS 0;5 SET
'XE' FOR ERROR-OTHER;
'XM' FOR ERROR-M CODE;
'F' FOR FINISHED;
'XL' FOR ERROR-LOCK;
LAST EDITED: JUL 11, 2003
DESCRIPTION: This field holds the additional information about the action taken by the master job for the
specific monitor recorded in multiple entries.
776.2051,6 RESULTS TIME 0;6 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAY 21, 2003
DESCRIPTION:
This field holds the time the RESULTS field is populated.
776.2051,7 ERROR REASON 0;7 FREE TEXT
INPUT TRANSFORM: K:$L(X)>30!($L(X)<3) X
LAST EDITED: MAY 21, 2003
HELP-PROMPT: Answer must be 3-30 characters in length.
DESCRIPTION: This field holds optional free-text data that further illuminates the actions taken by the master
job.
776.2051,8 EVENT JOB IEN (Free-Text) 0;8 FREE TEXT
INPUT TRANSFORM: K:$L(X)>12!($L(X)<1) X
LAST EDITED: MAY 23, 2003
HELP-PROMPT: Answer must be 1-12 characters in length.
DESCRIPTION: This field holds the task number of the background job created by the master job for a specific
monitor. When monitor jobs complete, their record is deleted by Taskman. For this reason, this
field is a free-text field, avoiding broken pointers.
FILES POINTED TO FIELDS
NEW PERSON (#200) QUEUE PERSON (#7)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):