News
Abstract
Message Monitor Replacement Variables
Content
You are in: IBM i Technology Updates > Navigator for i > Documentation on Functional Areas > Monitors > Message Monitors > Message Monitor Replacement Variables
Message Monitor Replacement Variables:
Replacement variables are available to customize your actions to the specific metric and values
These replacement variables can be used on the IBM i trigger command. For example, rather than just
| SNDMSG MSG(“message monitor”) TOUSR(*SYSOPR) |
You can use replacement variable:
| SNDMSG MSG('Monitor &MON triggered, ID= &MSGID.') TOUSR(*SYSOPR) |
Message Monitor Command Substitution Parameter Description & Lengths:
&DATE Date, length depends on format
The format and length for the date parameter (&DATE) depends on the system values QDATFMT & QDATSEP.
In most cases, the length of the variable &DATE will be 8.
For example:
If QDATFMT = MDY and QDATSEP is '/', the format will be MM/DD/YY (length=8)
If QDATFMT = DMY and QDATSEP is '-', the format will be DD-MM-YY (length=8)
A special case is when QDATFMT = JUL and QDATSEP='/'.
In this situation &DATE format will be YY/DDD (length = 6)
&MON Monitor name (variable length 1-64).
&TIME Time (length 6) HHMMSS.
&ENDPOINT Endpoint system name (variable length 1-256).
&EVENTTYPE Event type and defined as follows: (length 1)
Triggered With Command Event = 1
Triggered Without Command Event = 2
Manual Reset With Command Event = 3
Manual Reset Without Command Event = 4
Automatic Reset Event = 5
&MSGTEXT Provides the text from the message
*in release 7.3 and on added in new Navigator for i with 3-1-2022 PTFs
&FRMJOBNUMBER From job number for the message causing the trigger (length 6).
&FRMJOBNAME From job name for the message causing the trigger (variable length 1-10).
&FRMPROGRAM From program for the message causing the trigger (variable length 1-10).
&FRMUSER From job user for the message causing the trigger (variable length 1-10).
&MSGKEY Message key hex value (4-byte binary) identifying the message causing the trigger.
&MSGKEYCH Message key hex value (4-byte character array) identifying the message causing the trigger.
- • SNDMSG(&MSGKEYCH) is shown in ebcdic (unreadable)
- • If used as a variable, you may need to wrap it in single quotes and send as a string for it to be acceptable as a CL parameter parm('&MSGKEYCH')
&MSGID Message ID causing the trigger (length 7).
&MSGSEV Message severity causing the trigger (length 1-2).
&MSGTYPE Message type causing the trigger (length 2).
&MSGCOUNT Current message count that caused the trigger (length 1-3).
&OWNER Monitor owner (length 1-10)
&THRESHOLD Threshold number causing the trigger (length 1-3).
&TOLIB Message queue's library to which this message was sent (the library of the queue being monitored), (length 1-10).
&TOMSGQ Message queue name to which this message was sent (the queue being monitored), (length 1-10).
| Parameter | Length |
|---|---|
Notes:
There are no valid substitution values for these parameters if they are in the reset commands:
|
Was this topic helpful?
Document Information
Modified date:
31 March 2025
UID
ibm11163998