HL7 Event Monitor/Journal Growth

From VistApedia
Jump to: navigation, search

Up: HL7_Event_Monitor

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