Exception analysis for IMS messages
Message exception analysis is an OMEGAMON® for IMS facility that you can use to capture your IMS messages as exceptions.
Message exception analysis is activated from any OMEGAMON for IMS terminal with the ICNS
command.
To ensure that message exception analysis is activated, define the ICNS
command
in an initialization panel that is invoked at OMEGAMON for IMS session initialization. For
more information, see Screen spaces,
the ICNS
and OPTN
commands in the IBM® OMEGAMON for IMS on z/OS®: Realtime Commands Reference,
and the IBM OMEGAMON for IMS on z/OS: Planning and Configuration
Guide.
Listing, defining, and deleting messages with menus
- From the Main menu, select option P,
Profile.
The Profile menu displays.
- Select option F, Messages, from the Profile menu.
You see the Set Exception Messages menu.
- Select option B, Messages.
You see the SPECIFY EXCEPTION MESSAGES panel, which displays a list of IMS/MTO messages that are currently defined as shown in the following example.
Figure 1. Display of predefined IMS/MTO messages ________________ KOIMSGD VTM OI-II V530./C I91C 03/25/15 9:46:59 B > Help PF1 Back PF3 Up PF7 Down PF8 Save Profile PF22 > =============================================================================== > SPECIFY EXCEPTION MESSAGES > This is a list of all currently defined IMS/MTO messages (such as DFSnnn or > ICEnnn) that display under Exception Analysis. MSGD + M001 DFS144 OPTION = BUFSHOW + M002 DFS236 OPTION = BUFSHOW + M003 DFS243 OPTION = BUFFER . . . . . . . . . . . . + M024 DFS2179 OPTION = BUFSHOW + M025 DFS2473 OPTION = BUFSHOW + M026 DFS2474 OPTION = BUFSHOW > To add an IMS message, remove the > before MSGD below, and enter the specific > DFS message number. >MSGD ADD DFSnnn > To add an MVS message generated by an IMS region, remove the > before MSGD > below and enter the specific message number. >MSGD ADD ICEnnn > To delete an existing IMS/MTO message, remove the > before MSGD below, and > enter the specific DFS or MVS message number. > MSGD DELETE DFSnnn ===============================================================================
- Follow the instructions on the panel to define or delete messages.
Defining message exception display characteristics
- First, define the messages for message exception analysis on the SPECIFY EXCEPTION MESSAGES panel (option P.F.B from the Main menu).
- Next, enter the
XACB
command with the name of the message exception whose display characteristics you want to change. For example, enter:
Sample output is shown in the following figure.XACB LIST=M001
Figure 2. Defining message exception display characteristics XACB LIST=M001 : M001 + DISPLAY Parameters: THRESHOLD Parameters: XLF Parameters: : State=ON Threshold=N/A Auto=OFF : Group=IM Display=DEFAULT Log=OFF : Bell=OFF Attribute=NONE Limit=0 (0) : BOX Parameters: CYCLE Parameters: Repeat=NO : Boxchar=NO BOX ExNcyc=0 Persist=0 : Boxclr=NONE Stop=0 (0) SS= : Boxattr=NONE Cumulative=0
- Type over the setting for the display characteristic that you
want to change. For example, if you want the terminal bell to ring
when this exception trips, type
ON
after theBELL=
parameter for an audible signal. - To retain your changes after the current session, save them in a user profile. Use that profile for subsequent OMEGAMON for IMS sessions.