Expected messages
These are the normal messages that you should expect from each component involved in OMEGAMON® Data Provider. If data is not arriving at a destination analytics platform, but there are no obvious errors, then use these messages as a checklist to diagnose the problem.
A missing expected message indicates a problem. However, the cause of the problem is not necessarily at the point in processing where the message should occur. The cause might be upstream.
Components and their messages are presented here according to the direction of data flow: from the data source, to OMEGAMON Data Broker, and then to OMEGAMON Data Connect. The actual chronological order of some messages can differ from the order presented here.
Messages from OMEGAMON Data Provider might be interleaved with messages from other software, such as the operating system, a related component, or a supporting software framework. For example:
- The STDOUT file for OMEGAMON Data Connect includes messages from the Spring framework.
- The SYSPRINT output data set of the Zowe™ cross-memory server includes ZWE-prefix messages from the server that are not specific to the OMEGAMON Data Broker plug-in.
Data source
If you are using OMEGAMON monitoring agents as a data
source, then the RKLVLOG
output data set of each agent job (for example, job names
OM*
) should contain the following messages.
Message | Description |
---|---|
KAYL0005I KPQHSTxx: BROKER NAME = 'value' |
Echoes the value of the If this message is missing, check that your OMNIMON Base component meets the required APAR level for OMEGAMON Data Provider. For details, see Prerequisites for OMEGAMON Data Provider. |
KAYL0005I KPQHSTxx: PCODE='product',
TABLE='table_name', INTERVAL=interval,
DEST={destinations} … |
Echoes each entry under the If this message is missing for a table, check that there is a corresponding entry for the
table under the |
KPQH037I KPQHSMGR: TABLE
product.table_name HAS BEEN CONNECTED TO
PDS … |
Reports the first instance of a record for each table written to the PDS. This message is written only for tables that are explicitly specified under the
If this message is missing for a table, see OMEGAMON attributes not arriving at OMEGAMON Data Broker or PDS. |
KPQH038I KPQHSMGR: TABLE
product.table_name HAS BEEN CONNECTED TO
BROKER … |
Reports the first instance of a record for each table sent to OMEGAMON Data Broker. If this message is missing for a table, see OMEGAMON attributes not arriving at OMEGAMON Data Broker or PDS. |
For information about messages from other data sources, see the separate documentation for that software.
OMEGAMON Data Broker
The SYSPRINT
output data set of the Zowe
cross-memory server job that runs OMEGAMON Data Broker (for
example, job name KAYSIS01
) should contain the following messages.
Message | Description |
---|---|
KAYB0005I CIDB starting, version (APAR apar_number, build_time_stamp) |
Reports that OMEGAMON Data Broker is starting. Also reports the OMEGAMON Data Broker version and APAR number. Some messages use the term CIDB. CIDB is an abbreviation of Common Intercept Data Broker. CIDB is a synonym for OMEGAMON Data Broker. |
KAYB0009I Init step 'CIDB anchor initialization' done | Normal initialization message. |
KAYB0016I No CIDB ID has been provided |
Normal initialization message. OMEGAMON Data Provider users do not need to provide this ID. |
KAYB0016I Forwarder subsystem component is on | Corresponds to the OMEGAMON Data Broker configuration
parameter KAY.CIDB.FWD=ON . |
KAYB0009I Init step 'Load CIDB parameters' done
KAYB0009I Init step 'CIDB global area initialization' done KAYB0009I Init step 'CIDB ID generation' done, ID = 'cidb_id' KAYB0009I Init step 'CIDB store manager creation' done KAYB0020I Store 'store_name' has been added KAYB0009I Init step 'User defined store creation' done KAYB0009I Init step 'Forwarder subsystem initialization' done |
Normal initialization messages. |
KAYB0036I Forwarder forwarder_id has connected to sink host:port | OMEGAMON Data Broker has connected to OMEGAMON Data Connect. |
KAYB0009I Init step 'Forwarder subsystem startup' done
KAYB0006I CIDB successfully started |
Normal initialization messages. |
OMEGAMON Data Connect
The STDOUT
file of OMEGAMON Data Connect should
contain the following messages.
General messages, regardless of which outputs are enabled:
Message | Description |
---|---|
KAYC0026I Creating JSON mapping provider | Normal initialization message |
KAYC0023I Starting TCP input service listening on hostname:port | OMEGAMON Data Connect has started listening on hostname:port for TCP input from OMEGAMON Data Broker. |
KAYC0028I Source hostname:port has connected | The instance of OMEGAMON Data Broker that is at hostname:port has connected to OMEGAMON Data Connect. |
KAYC0038I Starting console listener | OMEGAMON Data Connect has started listening for console commands. For example, z/OS® MVS system MODIFY commands. |
KAYC0035I Build: build_identifier | Reports the OMEGAMON Data Connect build identifier. |
KAYC0067I Framework version = connect_framework_version | Identifies the version of the OMEGAMON Data Connect framework that was used to build the OMEGAMON Data Connect core JAR file, odp-server-version.jar. |
KAYC0068I Extension file jar_file_path found (spec=framework_version, impl=mapping_extension_version) | OMEGAMON Data Connect reports this message for each mapping extension JAR file that it finds in the directories that
are listed in the OMEGAMON Data Connect runtime option
-Dodp.ext . |
KAYC0069I class_count mapping classes found in jar_file_path | OMEGAMON Data Connect reports the number of mapping classes it finds in each mapping extension JAR file. |
KAYC0008I Creating mapping class for table table_name | Indicates the first instance of a record received for this table. |
KAYC0033I Table
table_name received from origin_type
origin_name … |
Indicates the first instance of a record received for this table from this origin. The origin type depends on the table. Examples: sysplex, CICS region. |
KAYC0036I
filter_scope filter selected table: table_name, fields:
field_list … |
OMEGAMON Data Connect has been configured to filter records of this table. |
If STDOUT output is enabled:
Message | Description |
---|---|
KAYC0024I Starting STDOUT output service | Normal initialization message. |
If TCP output is enabled:
Message | Description |
---|---|
KAYC0009I Starting TCP output service | Normal initialization message. |
Normal initialization messages for each sink. |
If HTTP output is enabled:
Message | Description |
---|---|
KAYC0076I Starting HTTP output service | Normal initialization message. |
Normal initialization message for each endpoint. |
If Prometheus output is enabled:
Message | Description |
---|---|
KAYC0018I Starting metrics service | Normal initialization message. |
KAYC0037I Registered
metric for table: table_name, field: field_name, type:
metric_type, labels:
[label_list] … |
Normal initialization message for each metric. |
If Kafka output is enabled:
Message | Description |
---|---|
KAYC0025I Starting Kafka output service | Normal initialization message. |
When OMEGAMON Data Connect stops:
Message | Description |
---|---|
Normal shutdown messages. | |
KAYC0032I Stopping TCP output service | If TCP output was enabled. |
KAYC0043I Stopping TCP sink: sink_name {host: hostname, port: port} | For each TCP output sink. |
KAYC0077I Stopping HTTP output service | If HTTP output was enabled. |
KAYC0081I Stopping output to HTTP endpoint: endpoint_name {url: url} | For each HTTP output endpoint. |