The INGMSGS command can be used to display exceptional messages. These are messages that have
been captured with a severity of either Unusual, Important or Critical.
You can also delete messages, which means:
Remove from INGMSGS display
Remove from SDF exceptional messages display
Send a clearing event via INGALERT
Issue a DOM if the message was not a WTOR
Syntax
delete options
dom options
Parameters
resource_name
An optional parameter used as a filter. Only exceptional
messages that are associated with the specified resource are shown.
The resource name can contain a wildcard. More than 1 resource name
can be specified. If no resource name is specified, only messages
that are not associated with a resource automated by SA z/OS® are taken into account (MVSESA).
REQ
Specifies the type of request to be performed:
DISPLAY
Displays all exceptional messages for the resource.
This is the default setting.
DATA
Displays all exceptional messages for the resource like DISPLAY, but uses an easily parsable
output format. OUTMODE=LINE is enforced. There is one output line for each message line of each
message containing the following tokens that are separated by '00'x:
Token sequence
Token description
1
Index of the message in this output
2
Reference value to uniquely identify the message
3
Timestamp when the message was captured
4
System message ID
5
Reply ID
6
Total number of message lines in the message
7
Line number of this message line
8
Message text of this message line
9
System where the message was captured
10
Severity specified when the message was captured:
U=Unusual, I=Important, C=Critical
11
Job name associated with the captured message
12
Resource name associated with the captured message
13
Comment specified when the message was captured
14
Qualifier specified when the message was captured
Leading and trailing blanks are stripped from the tokens, so some tokens might be of zero
length.
Deletes the message(s) based on the delete options.
RV
Specifies the reference value to uniquely identify a single message. The reference values are
available in the REQ=DATA output.
DOM
Specifies one or more IDs of messages to be deleted. The message
IDs must be separated by a blank character and enclosed in parenthesis
or quotes if more than one message ID is specified. The message ID
can contain wildcards.
QUAL
Specifies a qualifier that is used to identify the message in
addition to its message ID.
SEVERITY
Specifies the severity of the message used as Filter Criteria.
Valid entries are UNUSUAL, IMPORTANT and CRITICAL.
EXPIRED
Specifies the expiry date and time of the message. Any message
that was issued prior to the specified timestamp will be deleted when
also the other specified filter criteria match. The date format is
yyyy-mm-dd and the time format is hh:mm. The time specification is
optional.
The INGMSGS
command can only be used when SA z/OS has initialized.
A qualifier is not displayed when invoking INGMSGS in line
mode.
Example 1
If you enter ingmsgs a
panel similar to Figure 1 is displayed. Figure 1. INGMSGS Command
Dialog Panel
INGKYMSG SA z/OS - Command Dialogs Line 1 of 26
Domain Id . : IPUFA ------------ INGMSGS ------------ Date . . : 07/09/18
Operator Id : NETOP1 System = AOCA Time . . : 09:03:02
CMD: D Delete F INGINFO/DISPSYS
CMD Timestamp S Message
--- ------------------- - -----------------------------------------------------
2018-07-02 11:27:02 C SYSTEM=AOCA RESOURCE=CMDRCVR/APL/AOCA
QUAL=SUBSYSTEM/CMDRCVR
AOF577E 11:27:02 : RECOVERY FOR SUBSYSTEM CMDRCVR (JOB CMDRCVR) HALTE..
D - CRITICAL THRESHOLD EXCEEDED
2018-07-02 11:31:29 C SYSTEM=AOCA RESOURCE=R#AMFLGNO/APL/AOCA
IEFC452I R#AMFNO - JOB NOT RUN - JCL ERROR
2018-07-02 11:31:33 C SYSTEM=AOCA RESOURCE=R#E2EC03A/APL/AOCA
IEFC452I R#E2EC3A - JOB NOT RUN - JCL ERROR
2018-07-02 11:31:35 I SYSTEM=AOCA RESOURCE=LLA/APL/AOCA
IEF450I LLA LLA - ABEND=S023 U0000 REASON=00000204
TIME=11.31.35
2018-07-02 11:31:35 C SYSTEM=AOCA RESOURCE=LLA/APL/AOCA QUAL=SUBSYSTEM/LLA
AOF577E 11:31:35 : RECOVERY FOR SUBSYSTEM LLA (JOB LLA) HALTED - CRIT..
ICAL THRESHOLD EXCEEDED
2018-07-02 11:31:52 C SYSTEM=AOCA RESOURCE=R#C11LC/APL/AOCA
QUAL=SUBSYSTEM/R#C11LC
AOF577E 11:31:52 : RECOVERY FOR SUBSYSTEM R#C11LC (JOB C11APLC) HALTE..
D - CRITICAL THRESHOLD EXCEEDED
2018-07-02 11:32:30 I SYSTEM=AOCA RESOURCE=R#E2EBROKEN/APL/AOCA
IEF450I R#E2EBKN R#E2EBKN - ABEND=S0C1 U0000 REASON=00000001
TIME=11.32.29
2018-07-02 11:33:33 C SYSTEM=AOCA RESOURCE=R#UFILES/APL/AOCA
QUAL=SUBSYSTEM/R#UFILES
AOF577E 11:33:33 : RECOVERY FOR SUBSYSTEM R#UFILES (JOB R#UFILES) HAL..
TED - CRITICAL THRESHOLD EXCEEDED
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF8=Forward PF9=Refresh PF12=Retrieve
This panel displays exceptional messages
that have been captured by SA z/OS. An exceptional
message is a message whose severity is either Unusual, Important or
Critical. By default the messages are displayed in chronological order
(the oldest message is shown at the top of the panel) but can be rearranged
in any other order, for example, by severity with the SORT subcommand.
The individual messages are colored depending on their severity. The
color attribute is defined via SDF status definitions.
For
each message the following information is shown:
The Timestamp column shows the date and time when the message
was captured.
The S column shows the severity assigned to the message.
It can be:
U
Unusual
I
Important
C
Critical
The Message column shows the message text, the
system where the message was captured, the qualifier if present that
is associated with the message and the name of the resource associated
with the message. If no resource name is shown, the message is associated
with the system.
You can enter the following action codes in the Cmd field
to launch other commands:
D
Delete the message.
F
Shows details about the resource that is associated with the message
by invoking the INGINFO or DISPSYS command.
Example 2
The following example shows how to use INGMSGS REQ=DATA in a REXX program to output all messages
and their reference values. There is one output line for each message token that is explained in the
comment.
/* REXX */
sc='00'x /* set seperator character */
'PIPE NETV INGMSGS REQ=DATA', /* call INGMSGS */
' | STEM data.' /* store result in stem */
do i=1 to data.0 /* for each message line */
parse var data.i, /* parse into tokens */
ix, /* .. index of the message */
(sc) refval, /* .. reference value */
(sc) timestamp, /* .. timestamp */
(sc) smsgid, /* .. system message ID */
(sc) replid, /* .. reply ID */
(sc) lines, /* .. total number of msg lines */
(sc) line, /* .. current line number */
(sc) msgtext, /* .. message text of this line */
(sc) system, /* .. system */
(sc) severity, /* .. severity */
(sc) jobname, /* .. associated job name */
(sc) resname, /* .. associated resource */
(sc) comment, /* .. comment */
(sc) qualifier /* .. qualifier */
out = ix refval msgtext /* index, reference value and text */
'PIPE VAR out | CONS ONLY'
end
