Filtering Messages - ironstream_for_micro_focus_omi - 7.2

Ironstream for Micro Focus® OMi for IBM Z® Administration

Product type
Software
Portfolio
Integrate
Product family
Ironstream
Product
Ironstream > Ironstream for Micro Focus® OMi
Version
7.2
Language
English
Product name
Ironstream for Micro Focus OMi for IBM Z
Title
Ironstream for Micro Focus® OMi for IBM Z® Administration
Copyright
2021
First publish date
2007
ft:lastEdition
2023-08-23
ft:lastPublication
2023-08-23T16:21:59.136387

Filtering Messages on the Agent

Message filtering is performed on the IBM Z agent to reduce the amount of network traffic to the OMi Proxy Server. For details about message filtering, see the description of the FILTER mainframe console command in Appendix A and the FILTER SYSIN parameter card in the Installation Guide.

Filtering Messages on the Ironstream Proxy Server

Messages received from the mainframe node are passed through the Operations Agent Message stream interface. Although most mainframe system and application messages consist of a message ID and message text, the free form capacity of mainframe messages does not require this format.

In addition to the original message text, the following OMi optional variables are passed along with the message:

Table 4-1: Ironstream for IBM Z Optional Variables

Optional Variable

Message

$OPTION(jobname)

Job name (if any) which issued the message (up to 8 characters)

$OPTION(jobid)

Job ID (if any) which issued the message (up to 8 characters)

$OPTION(datestamp)

Date when the message was issued in MM.DD.YY format

$OPTION(timestamp)

Time when the message was issued in HH.MM.SS format

$OPTION(systemname)

System name where the message was generated (up to 8 characters)

$OPTION(msgkey)

Unique integer assigned to this message by z/OS

$OPTION(msgtoken)

Integer assigned to this message by z/OS to mark it as part of a group of related messages

These variables can be used in displayed message text as well as passed as arguments to automatic or operator-initiated actions. Automatic and operator-initiated actions may consist of native z/OS commands as well as scripts or programs. z/OS commands may be incorporated into scripts by using the ev390hostcmd utility program. See the details and syntax of the ev390hostcmd command on page 15.

Ironstream optionally allows some message attributes to be inserted directly into the original message text as it passes into OMi. Use the EVO_ADDFIELDS_TO_MSG option when configuring the agent connection to deliver the z/OS system name, job name, and job ID in the original message text. See the description of EVO_ADDFIELDS_TO_MSG in the section About Miscellaneous Parameters.

Multi-line MVS messages will be reformatted before being presented in the OMi browser. If an MVS message ID is added to the mainframe message filter table with a preceding plus sign “+”, then each line of the multi-line output will be sent with the message ID prepended to the front of the secondary lines. If a message ID is added to the mainframe message filter table with a preceding minus sign “-”, then each line of the multi-line output will be sent without the original message ID prepended to the front of the secondary lines. If the message ID is listed in the filter table with neither the “+” nor the “-” sign, then

all of the lines of the message will be concatenated together and displayed in the OMi browser as one continuous line, and each line of the multi-line message will be separated by a new-line character (\n). Select [Show Original Message…] from the Message Details window of the OMi browser to see the message displayed as multiple lines.