STANDARD DATA DICTIONARY #776 -- HL7 MONITOR JOB FILE 3/24/25 PAGE 1
STORED IN ^HLEV(776, (140 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: @
CROSS
REFERENCED BY: START TIME(B), MONITOR-PTR(M)
776,.01 START TIME 0;1 DATE (Required)
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 HL7 Monitor Job file (#776) entry was created.
CROSS-REFERENCE: 776^B
1)= S ^HLEV(776,"B",$E(X,1,30),DA)=""
2)= K ^HLEV(776,"B",$E(X,1,30),DA)
This cross-reference holds the time when the monitor started (was queued as a background job.)
776,2 COMPLETION TIME 0;2 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: AUG 22, 2003
DESCRIPTION:
This field holds the time the background job finished.
776,3 MONITOR-PTR 0;3 POINTER TO HL7 MONITOR FILE (#776.1)
LAST EDITED: AUG 22, 2003
DESCRIPTION: This field holds the internal entry number of the monitor entry in the HL Event Monitor file
(#776.1).
CROSS-REFERENCE: 776^M
1)= S ^HLEV(776,"M",$E(X,1,30),DA)=""
2)= K ^HLEV(776,"M",$E(X,1,30),DA)
With each Monitor Master Job run, the master job checks every monitor entry in the HL Event Monitor
file (#776.1). If it is "time" for the monitor to be queued, a background job is queued to run
that monitor. At the time of queueing an entry is created in this file holding (among other
values) the internal entry number of the monitor entry in file 776.1. The IEN is stored in the
Monitor field (#3), and this M cross-reference holds the IEN of the monitor.
Note: The Monitor field does not point to the monitor, strictly speaking,
because this field is a free-text field. However, since it holds
the IEN, it is a "functional pointer" to the monitor file.
(The field was created this way to enable monitors to be deleted
at will without worry about dangling pointers.)
776,4 STATUS-RUNTIME 0;4 SET
'E' FOR ERROR;
'F' FOR FINISHED;
'Q' FOR QUEUED;
'R' FOR RUNNING;
LAST EDITED: MAY 18, 2003
DESCRIPTION:
This field holds the run-time status of the background job.
776,5 STATUS-APPLICATION 0;5 FREE TEXT
INPUT TRANSFORM: K:$L(X)>10!($L(X)<1) X
LAST EDITED: MAY 18, 2003
HELP-PROMPT: Answer must be 1-10 characters in length.
DESCRIPTION:
This field holds the status provided by the application. Entry of this field is optional.
776,6 TIMESTAMP 0;6 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: MAY 18, 2003
DESCRIPTION: Periodically, during the running of the job, this field is updated with the time "now", which is
stored in this field.
776,7 MAILMAN PTR 0;7 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>999999999999)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: JUL 14, 2003
HELP-PROMPT: Type a Number between 1 and 999999999999, 0 Decimal Digits
DESCRIPTION: When the job finishes, if a notification Mailman message is sent, it's internal entry number if
stored in this field.
776,8 TASK NUMBER 0;8 NUMBER
INPUT TRANSFORM: K:+X'=X!(X>999999999999)!(X<1)!(X?.E1"."1N.N) X
LAST EDITED: MAY 23, 2003
HELP-PROMPT: Type a Number between 1 and 999999999999, 0 Decimal Digits
DESCRIPTION:
This field holds the task number for the background job.
776,9 MASTER JOB PTR 0;9 POINTER TO HL7 MONITOR MASTER JOB FILE (#776.2)
LAST EDITED: MAY 23, 2003
DESCRIPTION: The master job checks all monitors, and where appropriate queues background jobs for each monitor.
These background jobs are linked to this file, and to entries in this file. This field holds the
master job internal entry number in the HL7 Monitor Master Job file (#776.2).
776,10 QUEUE TIME 0;10 DATE
INPUT TRANSFORM: S %DT="ESTXR" D ^%DT S X=Y K:Y<1 X
LAST EDITED: JUN 10, 2003
DESCRIPTION: Normally, a background monitor job is queued to run now. However, at times a monitor job is queued
to a future time. When this occurs, the future queue time is stored in this field.
776,50 RUN DIARY 50;0 WORD-PROCESSING #776.001 (NOWRAP)
DESCRIPTION: Text is placed in this word processing field using the RUNDIARY^HLEVAPI API. The contents of this
field is under complete control by the using application.
LAST EDITED: MAY 18, 2003
776,51 MESSAGE TEXT 51;0 WORD-PROCESSING #776.002 (NOWRAP)
LAST EDITED: MAY 29, 2003
DESCRIPTION: Text is placed in this word processing field using the MSGTEXT^HLEVAPI API. The contents of this
field is under complete control by the using application.
LAST EDITED: MAY 29, 2003
776,52 VARIABLE VALUE 52;0 Multiple #776.003 (Add New Entry without Asking)
DESCRIPTION:
This field holds the variable names and values declared by the calling application.
776.003,.01 VARIABLE 0;1 FREE TEXT
INPUT TRANSFORM: K:$L(X)>30!($L(X)<1) X
LAST EDITED: MAY 23, 2003
HELP-PROMPT: Answer must be 1-30 characters in length.
CROSS-REFERENCE: 776.003^B
1)= S ^HLEV(776,DA(1),52,"B",$E(X,1,30),DA)=""
2)= K ^HLEV(776,DA(1),52,"B",$E(X,1,30),DA)
776.003,2 EXPLANATION 0;2 FREE TEXT
INPUT TRANSFORM: K:$L(X)>30!($L(X)<1) X
LAST EDITED: MAY 23, 2003
HELP-PROMPT: Answer must be 1-30 characters in length.
776.003,52 VALUE 52;E1,240 FREE TEXT
INPUT TRANSFORM: K:$L(X)>240!($L(X)<1) X
LAST EDITED: MAY 23, 2003
HELP-PROMPT: Answer must be 1-240 characters in length.
FILES POINTED TO FIELDS
HL7 MONITOR (#776.1) MONITOR-PTR (#3)
HL7 MONITOR MASTER JOB (#776.2) MASTER JOB PTR (#9)
INPUT TEMPLATE(S):
PRINT TEMPLATE(S):
SORT TEMPLATE(S):
FORM(S)/BLOCK(S):