Filter
Top Products
Note: To run the sample program “as is”, you must first create a model log stream
called 'CICSAD01.DEPT0001.MODEL100'. However, you will probably want
to tailor the sample to suit your own environment. The code contains
comments to help you do this.
Related concepts
“The log manager domain sample exit program” on page 23
Message domain exit XMEOUT
The XMEOUT exit allows you to suppress or reroute CICS and CICSPlex SM
messages that use the CICS message domain.
Your exit program is subject to certain restrictions:
v It cannot suppress or reroute messages sent to terminal operators, but only
those sent to the system console or to transient data queues. (XMEOUT is not
invoked for the former type of message.)
v It can suppress or reroute only messages that use the message domain. You
can deduce which CICS messages this applies to from the CICS Messages and
Codes : the description of each message that causes XMEOUT to be driven
contains a list of XMEOUT parameters; if no XMEOUT parameters are listed for
a message, the latter does not cause the exit to be driven. For example,
message DFHDX8320 causes XMEOUT to be invoked, but message
DFHDU0205 does not.
For CICSPlex SM, XMEOUT is invoked only for messages that have a
destination of EYULOG, as these are the messages that use the message
domain. You can deduce which messages this applies to from CICSPlex System
Manager Messages and Codes.
Note: CICSPlex SM messages that cause the XMEOUT exit to be driven, may
be rerouted or suppressed only from the joblog or console, not from the
EYULOG.
v It cannot reroute or suppress CICSPlex SM Web User interface messages.
v It cannot change the text of a message, nor the message inserts. (If it tries to do
so, CICS ignores the changes.)
v It cannot suppress or reroute messages issued during the early stages of CICS
initialization (because the exit cannot be enabled then).
v It cannot reroute a message to transient data queues during CICS shutdown
unless the original message destination included one or more transient data
queues. If it attempts to do so, the message in question is routed to its original
destination, and message DFHME0120I is issued to the console. Message
DFHME0120I cannot be rerouted by the user exit program but it may be
suppressed.
This restriction is necessary because the message domain is required to handle
messages during CICS shutdown even after the transient data queue function
has ended.
To discover whether CICS shutdown has started, your exit program can check for
the first instance of message DFHME0120. It can stop rerouting messages to TD
queues after DFHME0120 has been issued.
Note: If a message is being rerouted to a transient data queue and the transient
data request fails, the message is lost. The MEME exception trace point ID
X'0328' is written. The interpretation string of this trace entry provides an
explanation of why the transient data request failed.
168 Customization Guide