(Optional) Configure situation status streaming

Edit online

Enable situation status streaming from the Tivoli Enterprise Monitoring Server to IBM Z® OMEGAMON Data Provider. You must use Configuration Manager to configure situation status streaming.

Before you begin

Situation status streaming forwards situation status updates from the Tivoli Enterprise Monitoring Server (monitoring server) to IBM Z OMEGAMON Data Provider in JSON format. OMEGAMON® Data Provider can then forward the data to integrated third-party analytics platforms.

When situation status streaming is enabled, it is enabled for all situations; you cannot enable situation status streaming for only specific situations. For more information about using situation status streaming, see Stream situation status updates to OMEGAMON Data Provider.

About this task

The following list describes the requirements for configuring situation status streaming:

IBM Z OMEGAMON Data Provider (with APAR OA68403) must be installed and configured with OMEGAMON Data Broker and OMEGAMON Data Connect components configured and running and at least one analytics platform integrated. For more information, see Getting started with OMEGAMON Data Provider.
Note: If OMEGAMON Data Provider is not installed, the error message Unable to load KAY1ODP is displayed in the log.
Situation status streaming must be enabled by setting monitoring server parameter KDS_STREAM_SITUATION_STATUS to Y.
Situation status streaming requires mapping extension JAR file ksm-odp-model-v.jar.
Note: The three-character product code for situation status streaming is ksm.

Complete the following steps to configure situation status streaming.

Procedure

If you have not already done so, perform the steps to add OMEGAMON Data Provider to your runtime environment. The results describe the changes made to the runtime environment.
If you have not already done so, configure OMEGAMON Data Provider. See Getting started with OMEGAMON Data Provider.
(Optional) If you want to use the mapping extension JAR file for situation status streaming in your user directory, copy the ksm-odp-model-v.jar file to subdirectory rte_uss_rtedir/rte_name/kay/user/extensions from either of the following locations:
- For a full runtime environment: rte_uss_rtedir/rte_name/kay/kay-110/lib/ext/
- For a sharing runtime environment: gbl_uss_tkayhfs_path/kay-110/lib/ext/
In RTEDEF(KDS$PARM) or RTEDEF(KDS$lpar), add (or update, as appropriate) parameter KDS_STREAM_SITUATION_STATUS, and set the value to Y.
Run the GENERATE action to update the runtime environment configuration.
Restart the monitoring server.

What to do next

For information about the situation properties that are forwarded to OMEGAMON Data Provider, see Stream situation status updates to OMEGAMON Data Provider.