Display Message 2 allows several selection criteria to minimize the
number of messages that would be displayed or listed. For example,
you can display by message ID, message type, job, user, start/end
date/time, or the sending program. The DSPMSG2 command may be used
on any message queue, but would most likely be used with QSYSOPR.
A typical command would be:
DSPMSG2 MSGQ(QSYSOPR) MSGID(xxxxxxx)
A listing would be displayed with only the message IDs that match the
DSPMSG2 escape messages you can monitor for
None. Escape messages from based on functions will be re-sent.
DSPMSG2 Command parameters *CMD
MSGQ The qualified name of the message queue to be
displayed. The default is QSYSOPR.
The library value defaults to QSYS. A specific
library, *LIBL, or *CURLIB may also be used.
STRDAT The date to begin displaying messages. *BEGIN is
the default for the first date of a message that was
sent to the message queue. *TODAY or a specific
date (in job format) may be entered.
STRTIM The time associated with STRDAT to begin displaying
messages. *AVAIL is the default meaning the first
message with a date matching the STRDAT value.
ENDDAT The date to end displaying messages. *AVAIL is the
default meaning the date of the last message that
was sent to the message queue. A specific date may
be entered in job format.
ENDTIM The time associated with ENDDAT to end displaying
messages. *AVAIL is the default meaning the last
message with a date matching the ENDDAT value.
MSGTYPE A list of up 7 message types that will be displayed.
*ALL is the default for all types. The supported
values are *COMP, *DIAG, *INFO, *INQ, *SNDCPY, *RQS,
SEV The severity of the messages to be displayed. 00 is
the default which allows any severity to be
displayed. A value (00-99) may be entered to
request all severities *GE.
MSGID A list of up to 40 message IDs to be displayed.
*ALL is the default for all message IDs.
JOB The job that sent the message. *ALL is the default
for all jobs.
USER The user that sent the message. *ALL is the default
for all users.
SNDPGM The program that sent the message. *ALL is the
default for all programs.
SNDMODULE The module that sent the message. *ALL is the
default for all modules.
SNDPROC The procedure that sent the message. *ALL is the
default for all procedures.
MSGTXT The value to scan the message text for. Up to 20
bytes may be entered. Both the MSGTXT and the
message are folded to upper case before scanning.
LISTTYPE The type of listing to be output.
*BASIC is the default to list one line per message
with an abbreviated message text.
*DETAIL may be specified to list additional lines
per message. This includes the job number of the
job that sent the message, the sending program (or
module/procedure), the message file/library where
the message was sent from, and the full 256 bytes of
SEQ The sequence in the messages are to be displayed.
*ASCEND is the default to display in ascending
*DESCEND may be specified to display in descending
OUTPUT How to output the results. * is the default to
display the spooled file if the command is entered
interactively. If the display is ended with F3/F12
or the Enter key, the spooled file is deleted after
it is displayed. To retain the spooled file, you
may use the the System Request 'Cancel' function and
the spooled file will exist in a HLD status.
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
The following TAA Tools must be on your system:
CHKOBJ3 Check object 3
CVTDAT Convert date
CVTTIM Convert time
FMTLIN Format line
RSNLSTMSG Resend last message
RTVMSGQA Retrieve message queue attributes
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDSTSMSG Send status message
SORTDBF Sort data base file
TRNVAL Translate value
None, the tool is ready to use.
Objects used by the tool
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
DSPMSG2 *CMD TAAMSKJ QATTCMD
TAAMSKJC *PGM CLP TAAMSKJC QATTCL
TAAMSKJC2 *PGM CLP TAAMSKJC2 QATTCL
TAAMSKJR *PGM RPG TAAMSKJR QATTRPG