HL7 Event Monitor/Journal Growth
From VistApedia
Email of 20-Sep-2019 by David Whitten to Hardhats
Does anyone know about the ^XTMP global and the series of nodes apparently created by HL7 ?
ie: there are nodes in the ^XTMP() global with a first subscript of either: "HLEV CHK773AC "_<Timson Date+Time> or
"HLEV STUB "_<Timson Date+Time>
Apparently "HLEV" means Health Level Seven Event Monitoring.
The nodes seem to get SET in the HLEVX* routines. The dates on these routines are in February 2004 or so.
Notably the HLEV CHK773AC nodes are set in the routine ^HLEVX002
Soon after we copy our Production environment to make a test or training or development environment, there is something
that runs and fills up a LOT of journal files. This seems to be run as a background task since the Journal files have a
process id that has %ZTMS1 running if it finishes before we notice.
The sub-routine LIST^HLEVX lists these "monitors"
LIST N I,T W @IOF,$$CJ^XLFSTR("Official VistA HL7 Event Monitor Code",IOM),!,$$
;;
;;The "monitors" that are officially included in the VistA HL7 package are
;;listed below.
;;
;;Routine Monitor-Name
;;============================================================================
;;SYSTEM^HLEVX001^EVENT MONITOR
;;CHK870^HLEVX000^STUB 870 SEARCH & MORE
;;CHKXREF^HLEVX002^XREF CHECK - FILE 772 & 773
Q
I searched the OPTION File#19 for menus related to Monitoring and found these options:
Select OPTION: SEARCH FILE ENTRIES
OUTPUT FROM WHAT FILE: TASKS// 19 OPTION (10367 entries)
-A- SEARCH FOR OPTION FIELD: ROUTINE
-A- CONDITION: [ CONTAINS
-A- CONTAINS: HLEV
-B- SEARCH FOR OPTION FIELD:
IF: A// ROUTINE CONTAINS (case-insensitive) "HLEV"
STORE RESULTS OF SEARCH IN TEMPLATE:
SORT BY: NAME//
START WITH NAME: FIRST//
FIRST PRINT FIELD: [CAPTIONED
Include COMPUTED fields: (N/Y/R/B): NO// BOTH Computed Fields and Record Number
(IEN)
Heading (S/C): OPTION SEARCH//
DEVICE: TELNET
OPTION SEARCH SEP 20,2019 14:27 PAGE 1
--------------------------------------------------------------------------------
NUMBER: 9978 NAME: HLEV EDIT MASTER
MENU TEXT: Edit parameters TYPE: run routine
CREATOR: WVEHR,PATCH INSTALLER ROUTINE: E7769^HLEVSTUP
UPPERCASE MENU TEXT: EDIT PARAMETERS
NUMBER: 9979 NAME: HLEV EDIT MASTER ON-OFF
MENU TEXT: Turn on/off monitoring TYPE: run routine
CREATOR: WVEHR,PATCH INSTALLER ROUTINE: ONOFFPAR^HLEVAPI0
UPPERCASE MENU TEXT: TURN ON/OFF MONITORING
NUMBER: 9976 NAME: HLEV EDIT MONITOR
MENU TEXT: Enter/edit event monitors TYPE: run routine
CREATOR: WVEHR,PATCH INSTALLER ROUTINE: E7761^HLEVSTUP
UPPERCASE MENU TEXT: ENTER/EDIT EVENT MONITORS
NUMBER: 9977 NAME: HLEV EDIT MONITOR ON-OFF
MENU TEXT: Turn on/off event monitor TYPE: run routine
CREATOR: WVEHR,PATCH INSTALLER ROUTINE: ONOFFEV^HLEVAPI0
UPPERCASE MENU TEXT: TURN ON/OFF EVENT MONITOR
NUMBER: 9991 NAME: HLEV GRANT REMOTE LICENSE
MENU TEXT: Grant remote request license
TYPE: run routine CREATOR: WVEHR,PATCH INSTALLER
PACKAGE: HEALTH LEVEL SEVEN ROUTINE: OPENMAIL^HLEVSRV3
UPPERCASE MENU TEXT: GRANT REMOTE REQUEST LICENSE
NUMBER: 9986 NAME: HLEV MASTER JOB NOW
MENU TEXT: Run monitor master job now
TYPE: run routine CREATOR: WVEHR,PATCH INSTALLER
PACKAGE: HEALTH LEVEL SEVEN ROUTINE: MSTNOW^HLEVMST0
UPPERCASE MENU TEXT: RUN MONITOR MASTER JOB NOW
NUMBER: 9981 NAME: HLEV MASTER JOB START
MENU TEXT: Monitoring master job start
TYPE: run routine CREATOR: WVEHR,PATCH INSTALLER
PACKAGE: HEALTH LEVEL SEVEN ROUTINE: STARTMST^HLEVMST0
UPPERCASE MENU TEXT: MONITORING MASTER JOB START
NUMBER: 9982 NAME: HLEV MASTER JOB STOP
MENU TEXT: Stop monitoring master job
TYPE: run routine CREATOR: WVEHR,PATCH INSTALLER
PACKAGE: HEALTH LEVEL SEVEN ROUTINE: UNQUEUE^HLEVMST0
UPPERCASE MENU TEXT: STOP MONITORING MASTER JOB
NUMBER: 9984 NAME: HLEV MONITOR DETAILS
MENU TEXT: Results of a monitor run TYPE: run routine
CREATOR: WVEHR,PATCH INSTALLER PACKAGE: HEALTH LEVEL SEVEN
ROUTINE: CTRL^HLEVREP2
UPPERCASE MENU TEXT: RESULTS OF A MONITOR RUN
NUMBER: 9983 NAME: HLEV MONITOR MAP REPORT
MENU TEXT: Map of monitoring activity
TYPE: run routine CREATOR: WVEHR,PATCH INSTALLER
PACKAGE: HEALTH LEVEL SEVEN ROUTINE: CTRL^HLEVREP1
UPPERCASE MENU TEXT: MAP OF MONITORING ACTIVITY
NUMBER: 9980 NAME: HLEV ONE-TIME MONITOR RUN
MENU TEXT: One-time monitor run TYPE: run routine
CREATOR: WVEHR,PATCH INSTALLER PACKAGE: HEALTH LEVEL SEVEN
ROUTINE: ONETIME^HLEVAPI1
UPPERCASE MENU TEXT: ONE-TIME MONITOR RUN
NUMBER: 9973 NAME: HLEV PRINT MASTER SETUP
MENU TEXT: Settings of monitoring parameters
TYPE: run routine CREATOR: WVEHR,PATCH INSTALLER
ROUTINE: VIEW7769^HLEVREP(1)
UPPERCASE MENU TEXT: SETTINGS OF MONITORING PARAMET
NUMBER: 9972 NAME: HLEV PRINT MONITOR SETUP
MENU TEXT: Monitor setup details TYPE: run routine
CREATOR: WVEHR,PATCH INSTALLER ROUTINE: SHOW7761^HLEVREP
UPPERCASE MENU TEXT: MONITOR SETUP DETAILS
NUMBER: 9989 NAME: HLEV REPORT CONDENSED MONITOR
MENU TEXT: Condensed monitor report TYPE: run routine
CREATOR: WVEHR,PATCH INSTALLER ROUTINE: CONDMON^HLEVREP0
UPPERCASE MENU TEXT: CONDENSED MONITOR REPORT
NUMBER: 9988 NAME: HLEV REPORT MONITOR RECIPIENTS
MENU TEXT: Message recipients TYPE: run routine
CREATOR: WVEHR,PATCH INSTALLER ROUTINE: RECIP^HLEVREP0
UPPERCASE MENU TEXT: MESSAGE RECIPIENTS
NUMBER: 9990 NAME: HLEV REPORT REMOTE REQUESTABLE
MENU TEXT: Remote requestable report TYPE: run routine
CREATOR: WVEHR,PATCH INSTALLER ROUTINE: REMREQO^HLEVREP3
UPPERCASE MENU TEXT: REMOTE REQUESTABLE REPORT
NUMBER: 9985 NAME: HLEV-INFORMATION-SERVER
MENU TEXT: Event monitoring server TYPE: server
CREATOR: DEWAYNE,ROBERT PACKAGE: HEALTH LEVEL SEVEN
ROUTINE: HLEVSRV SERVER BULLETIN: XQSERVER
SERVER ACTION: RUN IMMEDIATELY SERVER MAIL GROUP: HLEV SERVER
SERVER AUDIT: NO SUPRESS BULLETIN: YES, SUPRESS IT
SERVER REPLY: REPLY ON ERROR ONLY SAVE REQUEST: Do not save request
UPPERCASE MENU TEXT: EVENT MONITORING SERVER
17 MATCHES FOUND.
I ran the apparent top menu:
Select OPTION NAME: HLEV MENU MAIN Event monitoring menu
Master job not started. Not time yet...
-------- Master job status is ACTIVE --------
Last master job run was 9 min 51 sec ago...
Next run [task# 4556391] is 1 hr 50 min 9 sec in the future...
-------- Event monitoring status is ACTIVE --------
Setup & maintenance options ... [HLEV MENU SETUP]
Run-time options ... [HLEV MENU RUNTIME]
Select Event monitoring menu Option: Run-time options
Settings of monitoring parameters [HLEV PRINT MASTER SETUP]
Monitor setup details [HLEV PRINT MONITOR SETUP]
One-time monitor run [HLEV ONE-TIME MONITOR RUN]
Map of monitoring activity [HLEV MONITOR MAP REPORT]
Results of a monitor run [HLEV MONITOR DETAILS]
Run monitor master job now [HLEV MASTER JOB NOW]
Select Run-time options Option:
Select Event monitoring menu Option: SETup & maintenance options
Monitor setup & maintenance ... [HLEV MENU SETUP-MONITOR]
System setup & maintenance ... [HLEV MENU SETUP-MASTER]
Reports ... [HLEV MENU REPORTS]
Select Setup & maintenance options Option: REPOrts
Condensed monitor report [HLEV REPORT CONDENSED MONITOR]
Message recipients [HLEV REPORT MONITOR RECIPIENTS]
Remote requestable report [HLEV REPORT REMOTE REQUESTABLE]
Select Reports Option: CONDensed monitor report
Short Monitor Report
================================================================================
This option displays monitor information in brief format. If you wish to see
more of the information for this monitor, please use the 'Expanded monitor
report' menu option.
* Previous selection: NAME from A to ZZZ
START WITH NAME: A//
GO TO NAME: ZZZ//
DEVICE: 0;P-OTHER;79;1000 TELNET
Monitor report SEP 20,2019 14:32 PAGE 1
REQUE
NAME STATUS MIN M STARTUP
-------------------------------------------------------------------------------
CHECK 773 AC XREF ACTIVE 1440 CHECKAC~HLEVX002
EVENT MONITOR ACTIVE 480 MOTHER~HLEVX001
FAST HL7 PURGE #1 ACTIVE 60 FAST1~HLUOPTF2
FAST HL7 PURGE #2 ACTIVE 180 FAST2~HLUOPTF2
LINK (870) CHECKS ACTIVE 720 CHK870~HLEVX000
PURGE EVENT LOG ACTIVE 1440 PURGE~HLEMEP
SEND EVENTS ACTIVE 30 SENDALL~HLEMSND
It seems simple enough to turn off:
Select System setup & maintenance Option: TURN on/off monitoring
System Parameters
================================================================================
Name: SYSTEM
Status Fields
---------------------------------
Status - MASTER: ACTIVE
Status - EVENT: ACTIVE
Requeue Frequency for Master Job
----------------------------------------------------
Requeue minutes - MASTER: 120min
Purge Parameters ("Cutoff" hours)
-----------------------------------------------------
Purge hours - RUNTIME DATA: 96hr
Change 'STATUS-MASTER JOB' to INACTIVE? No// YES changed!
Change 'STATUS-EVENT MONITORING' to INACTIVE? No// YES changed!
System Parameters
================================================================================
Name: SYSTEM
Status Fields
---------------------------------
Status - MASTER: INACTIVE
Status - EVENT: INACTIVE
Requeue Frequency for Master Job
----------------------------------------------------
Requeue minutes - MASTER: 120min
Purge Parameters ("Cutoff" hours)
-----------------------------------------------------
Purge hours - RUNTIME DATA: 96hr
So this apparently these tools let us track possible problems with HL7 messaging.
The question I have to ask is why they seem to explode our journal space when
we first start up the non-production environment.
The burning question is, should we turn this monitor off or leave it on ?
Does it matter only in production environments or does it matter in non-production?
Does any know if we should be checking these reports regularly ?
Are problems with HL7 that these monitors find either common or uncommon ?
Thanks for your input.
Dave Whitten
713-870-3834
PS: I put this e-mails data at
http://www.vistapedia.com/index.php/HL7_Event_Monitor/Journal_Growth
and did find a document from 2004 which may be relevant:
Event Monitor Development Guide (HL7 Patch 106) - VA.gov
https://www.va.gov/vdl/documents/Infrastructure/Health_Level_7_(HL7)/hl71_6p109sp.doc
VA Document (on this wiki) : File:Hl71 6p109sp.doc
